diff --git a/getting-started/download-product-files.md b/getting-started/download-product-files.md new file mode 100644 index 00000000..73965da6 --- /dev/null +++ b/getting-started/download-product-files.md @@ -0,0 +1,50 @@ +--- +title: Download Product Files +description: Learn how to download the source code, pdf documentation, different versions from your Telerik account. +page_title: Download Product Files +slug: download-product-files +tags: download, dpl, product, file, assets, distribution +published: True +position: 4 +--- + +# Download Product Files + +As of **Q2 2025** the [Telerik Document Processing]({%slug introduction%}) libraries are available as a separate distribution in the **Downloads** section of your [Telerik account](https://www.telerik.com/account/). + +Since the **Telerik Document Processing** is a part of several [Telerik bundles](https://www.telerik.com/purchase.aspx) and it is installed following the steps for installing the suite with which you've obtained the product, when you purchase a Telerik license, you can download the following files: + +* Latest Public version + +* Latest [Preview version]({%slug obtain-use-latest-internal-build-version%}) + +* Assemblies available as NuGet packages + +* Previous versions + +* Source code + +* Documentation files + +Тo download these files, follow the steps below: + +1\. Log into [your Telerik account](https://www.telerik.com/account/) and click the **Downloads** option: + +![Downloads in Your Account](images/downloads-account.png) + +2\. Select **Telerik Document Processing**: + +![DPL Downloads in Your Account](images/dpl-downloads-account.png) + +3\. Select an asset you want to download: DLLs, PDB files, NuGet Packages, documentation files, or Source code: + +![DPL Product Files](images/dpl-product-files.png) + +4\. You can choose between official Public versions or Preview versions (if such exist) according to the activation date of your license. From the **Version** drop down list, you can also select which specific version to download. + +>important If you are looking for a specific version, but it isn't listed in the Version list, please contact our sales team: **sales@telerik.com**. They will make the required version available for download. + +## See Also + +* [What Versions of Document Processing Libraries are Distributed with the Telerik Products]({%slug distribute-telerik-document-processing-libraries-net-versions%}) +* [Latest Internal Build (Preview Version)]({%slug obtain-use-latest-internal-build-version%}) \ No newline at end of file diff --git a/getting-started/images/downloads-account.png b/getting-started/images/downloads-account.png new file mode 100644 index 00000000..094b82cd Binary files /dev/null and b/getting-started/images/downloads-account.png differ diff --git a/getting-started/images/dpl-downloads-account.png b/getting-started/images/dpl-downloads-account.png new file mode 100644 index 00000000..8e791321 Binary files /dev/null and b/getting-started/images/dpl-downloads-account.png differ diff --git a/getting-started/images/dpl-product-files.png b/getting-started/images/dpl-product-files.png new file mode 100644 index 00000000..89fa2510 Binary files /dev/null and b/getting-started/images/dpl-product-files.png differ diff --git a/knowledge-base/before-q2-2025.md b/knowledge-base/before-q2-2025.md new file mode 100644 index 00000000..bc1f0afd --- /dev/null +++ b/knowledge-base/before-q2-2025.md @@ -0,0 +1,61 @@ +--- +title: Licensing before 2025 +page_title: "Licensing mechanism before Q2 2025 explained." +description: "Learn more about Licensing in Telerik Document Processing before Q2 2025 and how you may upgrade your Trial license to Purchase license" +type: how-to +slug: licensing-before-q2-2025 +tags: licensing, dpl, document, processing, before, 2025, trial, dev +published: True +position: 4 +--- + +# Licensing before 2025 + +[Telerik Document Processing]({%slug introduction%}) used to come in separate **Trial** and **Developer** (or commercial) assets distribution until Q2 2025. + +![License Mechanism](images/license-mechanism.png) + +>caution After launching the [new licensing mechanism](https://www.telerik.com/blogs/license-key-files-telerik-kendo-ui-products-2025-update), the activation is performed through a [license key]({%slug setting-up-license-key%}) (trial or commercial). Upgrading from a Trial to Developer (or commercial) version requires only updating the license key without the necessity of reinstalling the respective Telerik product. + +## Trial Licenses + +Telerik Document Processing is available under a 30-day trial license with a full-featured version of the tool—no restrictions! What’s more, you are eligible for complete technical support during your trial period in case you have any questions. + +The free trial licenses of all Telerik products are fully functional and will work for an unlimited time, but will randomly display a copyright message. These builds have the `Trial` abbreviation in their file names. To use the trial version of Telerik Document Processing, you need to agree to the [End User License Agreement (EULA)]({%slug license-agreement%}). + +* To sign up for a free 30-day trial, [Log in to your Telerik account or create one](https://www.telerik.com/account). +* To download the trial version, refer to the [Telerik Document Processing's Product page](https://www.telerik.com/document-processing-libraries). +* To download a developer build with a trial license, log into your [Telerik account](https://www.telerik.com/account/). + +## Developer Licenses + +Telerik Document Processing also offers a developer license. To use Telerik Document Processing commercially, you need to purchase a license and to agree to the terms of use, which are fully described in the [End User License Agreement (EULA)]({%slug license-agreement%}). + +Developer licenses come with modified DLLs, which work without displaying copyright messages. If you have a Developer license for one or more Telerik components, you need to ensure that you are using the developer build when downloading the libraries. These builds have the `Dev` abbreviation in their file names. + +If your application is displaying a copyright message intermittently, this means that you are using a trial version of the product. Log in to your [Telerik account and download](https://www.telerik.com/account/downloads) the developer build by choosing the product from the available Licenses. + +For more information on the commercial terms, refer to the pricing list of the [available developer licenses which include Telerik Document Processing](https://www.telerik.com/purchase.aspx) + +## Upgrading from Trial to Developer + +To upgrade the trial version of your license to a developer license: + +1. Back up your Telerik Document Processing files and folders especially if your project uses the settings that are included in them. +1. Uninstall the __Trial__ version of the Telerik product with which you have obtained the Document Processing libraries either by using the __Start Menu__ shortcut or the __Add/Remove Programs__ dialog. +1. Obtain the new __Dev__ installer and [install Telerik Document Processing]({%slug installation-installing-on-your-computer%}). + +>note More information is available in the following KB article: [How to Upgrade Trial to Licensed Version]({%slug upgrade-trial-to-licensed-version%}). + +## Redistribution + +Telerik Document Processing is a part of several [Telerik bundles](https://www.telerik.com/purchase.aspx) and is licensed under the conditions with which you've obtained the product. Read more in the [Redistributing Telerik Document Processing]({%slug installation-deploying-telerik-document-processing%}) topic. + +For further discussing your planned use of Telerik Document Processing, send an email to [sales@Telerik.com](mailto:sales@Telerik.com). + +# See Also + +* [Trial vs Licensed version]({%slug trial-license-limitations%}) +* [Installing on Your Computer]({%slug installation-installing-on-your-computer%}) +* [Install using NuGet Packages]({%slug installation-nuget-packages%}) +* [Download Product Files]({%slug download-product-files%}) \ No newline at end of file diff --git a/knowledge-base/images/license-mechanism.png b/knowledge-base/images/license-mechanism.png new file mode 100644 index 00000000..def9e7af Binary files /dev/null and b/knowledge-base/images/license-mechanism.png differ diff --git a/libraries/radpdfprocessing/features/digital-signature/images/radpdfprocessing-features-digital-signature-pdfstreamsigner.png b/libraries/radpdfprocessing/features/digital-signature/images/radpdfprocessing-features-digital-signature-pdfstreamsigner.png new file mode 100644 index 00000000..538f4e2e Binary files /dev/null and b/libraries/radpdfprocessing/features/digital-signature/images/radpdfprocessing-features-digital-signature-pdfstreamsigner.png differ diff --git a/libraries/radpdfprocessing/features/digital-signature/limitations.md b/libraries/radpdfprocessing/features/digital-signature/limitations.md index 40518818..9ec22c23 100644 --- a/libraries/radpdfprocessing/features/digital-signature/limitations.md +++ b/libraries/radpdfprocessing/features/digital-signature/limitations.md @@ -4,7 +4,7 @@ description: Learn what are the limitations related to the usage of digital sign page_title: Limitations slug: radpdfprocessing-features-signature-validation tags: digital, signature, limitations -position: 2 +position: 3 --- # Limitations diff --git a/libraries/radpdfprocessing/features/digital-signature/pdfstreamsigner.md b/libraries/radpdfprocessing/features/digital-signature/pdfstreamsigner.md new file mode 100644 index 00000000..d2a98908 --- /dev/null +++ b/libraries/radpdfprocessing/features/digital-signature/pdfstreamsigner.md @@ -0,0 +1,33 @@ +--- +title: PdfStreamSigner +description: Learn how to add multiple Digital Signatures to a PDF document using PdfStreamSigner. +page_title: PdfStreamSigner +slug: radpdfprocessing-features-digital-signature-pdfstreamsigner +tags: pdfprocessing, document, processing, pdf, digital, sigature, stream, writer, multiple, sign +published: True +position: 1 +--- + +# PdfStreamSigner + +As of **Q2 2025** RadPdfProcessing intorduces the **PdfStreamSigner**. The **SignDocument** method it exposes allows the user to insert one or more [Digital Signatures]({%slug radpdfprocessing-features-digital-signature%}) into a PDF document. + +|Method|Description| +|----|----| +|**PdfStreamSigner(Stream outputStream)**|Creates a new instance of thе PdfStreamSigner and specifies the output stream of the signed document.| +|**SignDocument(Stream originalStream, SignatureField signatureField, int pageIndex, TimeSpan? timeout)**|Adds a [Digital Signature]({%slug radpdfprocessing-features-digital-signature%}) to the PDF document| + +The following example shows how to insert multiple [Digital Signatures]({%slug radpdfprocessing-features-digital-signature%}) into a PDF document using the PdfStreamSigner: + +>important In .NET Standard use __Telerik.Documents.Primitives.Rect__ instead of __System.Windows.Rect__. + +>important When adding multiple signatures, make sure the document is exported after each signature before importing it back again. + + + +![PdfProcessing Multiple Digital Signatures](images/radpdfprocessing-features-digital-signature-pdfstreamsigner.png) + +## See Also + + * [Digital Signature]({%slug radpdfprocessing-features-digital-signature%}) + * [Signature Field]({%slug radpdfprocessing-model-interactive-forms-form-fields-signaturefield%}) \ No newline at end of file diff --git a/libraries/radpdfprocessing/features/digital-signature/signature-validation.md b/libraries/radpdfprocessing/features/digital-signature/signature-validation.md index c879e4db..10dd6887 100644 --- a/libraries/radpdfprocessing/features/digital-signature/signature-validation.md +++ b/libraries/radpdfprocessing/features/digital-signature/signature-validation.md @@ -4,7 +4,7 @@ description: The digital signature feature enables you to sign and validate a PD page_title: Signature Validation slug: radpdfprocessing-features-signature-validation tags: digital, signature, validate -position: 1 +position: 2 --- ## Validating a Signature diff --git a/libraries/radpdfprocessing/formats-and-conversion/ocr/prerequisites.md b/libraries/radpdfprocessing/formats-and-conversion/ocr/prerequisites.md index 50083d1a..671c341f 100644 --- a/libraries/radpdfprocessing/formats-and-conversion/ocr/prerequisites.md +++ b/libraries/radpdfprocessing/formats-and-conversion/ocr/prerequisites.md @@ -14,7 +14,7 @@ position: 0 This topic describes the requirements needed by the [PdfProcessing]({%slug radpdfprocessing-overview%}) library to start using the **OcrFormatProvider**. ->important The default Tesseract implementation is at this point **Windows-only**. You can still use the OCR feature with a [custom implementation]({%slug radpdfprocessing-formats-and-conversion-ocr-custom-ocrprovider%}). +>important The default Tesseract implementation is at this point **Windows** and **Linux-only**. You can still use the OCR feature with a [custom implementation]({%slug radpdfprocessing-formats-and-conversion-ocr-custom-ocrprovider%}). >note Used images should be **300 DPI** for best results. @@ -80,6 +80,20 @@ In order to use the **OcrFormatProvider** you need to add the following assembli Telerik.Documents.ImageUtils depends on SkiaSharp. + + - + + SkiaSharp.NativeAssets.* (version 2.88.8) +
+ May differ according to the used platform. For Linux (since Q2 2025) use SkiaSharp.NativeAssets.Linux.NoDependencies and execute the required commands. + + + - + + SkiaSharp.Views.Blazor and wasm-tools +
+ For Blazor Web Assembly. + @@ -103,7 +117,7 @@ tessdata ``` ![tessdata Structure](images/tessdata-structure.png) -### Manually set up the Tesseract native assemblies +## Manually set up the Tesseract native assemblies Ensure that the following already exist in the root directory of your project: - The "_Tesseract.dll_" assembly. @@ -113,7 +127,6 @@ Ensure that the following already exist in the root directory of your project: If these requirements are not met, go through the following steps: -1. [Extract the "Tesseract.dll" assembly from the _Telerik.Windows.Documents.TesseractOcr_ NuGet package and add it to your project]({%slug extract-assemblies-from-nuget%}). 1. Download the "_tesseract50.dll_" and "_leptonica-1.82.0.dll_" native assemblies from the listed links: * https://github.com/charlesw/tesseract/tree/master/src/Tesseract/x64. * https://github.com/charlesw/tesseract/tree/master/src/Tesseract/x86. @@ -128,9 +141,22 @@ If these requirements are not met, go through the following steps: ├── tesseract50.dll └── leptonica-1.82.0.dll ``` + +### Linux-specific steps +Execute the following commands in the environment: +|Ubuntu|Alpine|Fedora| +|----|----|----| +|```sudo apt update```|```dsudo apk update```|```sudo dnf install tesseract```| +|```sudo apt install tesseract-ocr```|```sudo apk add tesseract-ocr```|```sudo dnf install leptonica```| +|```sudo apt install libleptonica-dev```|```sudo apk add leptonica```|| +>caution If the generated **tesseract/leptonica** .so files cannot be found, it is likely that they were installed with different names than expected. To resolve this, you can copy their names and location, and set them to the corresponding properties: +> * **TesseractEnvironment.TesseractUnixLibName** +> * **TesseractEnvironment.LeptonicaUnixLibName** +> * **TesseractEnvironment.CustomSearchPath** ## See Also * [Using OcrFormatProvider]({%slug radpdfprocessing-formats-and-conversion-ocr-ocrformatprovider%}) * [Implementing a Custom OCR Provider]({%slug radpdfprocessing-formats-and-conversion-ocr-custom-ocrprovider%}) +* [Cross-Platform Images]({%slug radpdfprocessing-cross-platform-images%}) diff --git a/libraries/radpdfprocessing/formats-and-conversion/pdf/pdfformatprovider/settings.md b/libraries/radpdfprocessing/formats-and-conversion/pdf/pdfformatprovider/settings.md index bc863f38..92d8f705 100644 --- a/libraries/radpdfprocessing/formats-and-conversion/pdf/pdfformatprovider/settings.md +++ b/libraries/radpdfprocessing/formats-and-conversion/pdf/pdfformatprovider/settings.md @@ -49,7 +49,6 @@ The **PdfFormatProvider** class offers the **ExportSettings** property which all |Property|Description| |----|----| |**StripJavaScriptActions**|Specifies if the PDF document should strip JavaScript actions on export. *Introduced in Q4 2024*. The default value is **false**.| -|**ShouldEmbedFonts** (obsolete)|Specifies whether the font files should be embedded in the PDF document. The default value is *true* because the fonts should be embedded in the file by the PDF Standard. This means that by default the fonts are added which allows proper viewing on any device. If the fonts are not embedded and the file is viewed on a device that does not have the used fonts the font might be substituted. If the font is embedded in the PDF file, it ensures the most predictable and dependable results. As of **Q2 2024** the **ShouldEmbedFonts** property is obsolete. Use the **FontEmbeddingType** property instead.| |**FontEmbeddingType**|The property controls what part of the fonts will be embedded in the file offering the following options: The subset export option is currently implemented **only** for TrueType fonts (.ttf).| |**IsEncrypted**|This property specifies if the document should be encrypted. The default value is *false*. You can specify the encryption algorithm by setting the **EncryptionType** property. The supported values are **AES256** and **RC4**.
**All passwords for revision 6 (AES-256) shall be based on Unicode**. Preprocessing of a user-provided password consists first of normalizing its representation by applying the "SASLPrep" profile (Internet RFC 4013) of the "stringprep" algorithm (Internet RFC 3454) to the supplied password using the Normalize and BiDi options.
This setting is ignored when __ComplianceLevel__ differs from __None__ as PDF/A compliant documents do not allow encryption.| |**UserPassword**|The password to be used if the document is encrypted. The default password is an empty string.| diff --git a/libraries/radpdfprocessing/formats-and-conversion/pdf/pdfstreamwriter/pdfstreamwriter.md b/libraries/radpdfprocessing/formats-and-conversion/pdf/pdfstreamwriter/pdfstreamwriter.md index 9b67c771..6b3582b3 100644 --- a/libraries/radpdfprocessing/formats-and-conversion/pdf/pdfstreamwriter/pdfstreamwriter.md +++ b/libraries/radpdfprocessing/formats-and-conversion/pdf/pdfstreamwriter/pdfstreamwriter.md @@ -7,6 +7,18 @@ published: True position: 2 --- + + # Overview The **PdfStreamWriter** class enables you to write file content directly to a Stream. This is the root element of the streaming mechanism used when exporting a PDF document. @@ -87,23 +99,19 @@ The members of the class allow you to set several properties of the document you ### Settings of PdfStreamWriter -Through the **Settings property** of PdfStreamWriter you can control the way the document is exported. The following list describes the available properties: - -* **DocumentInfo**: A property of type [RadFixedDocumentInfo](https://docs.telerik.com/devtools/document-processing/api/Telerik.Windows.Documents.Fixed.Model.RadFixedDocumentInfo.html), intended to hold additional information about the document. The RadFixedDocumentInfo class allows you to set the title, author and description of the document. - -* **ImageQuality**: This property is of type [ImageQuality]({%slug radpdfprocessing-concepts-imagequality%}) and gets or sets the default image quality when exporting images to PDF. The default value is *High*. The value of this property is overridden when specifying the ImageQuality in ImageSource constructor or when creating [ImageSource]({%slug radpdfprocessing-model-imagesource%}) from EncodedImageData. The quality of the images reflects the size of the PDF file. The higher the quality, the bigger the document size is. +Through the **Settings** property of PdfStreamWriter you can control the way the document is exported. The following list describes the available properties: -* **ImageCompression**: Gets or sets the image compression type. The possible values are: - - **None**: No compression will be used. - - **Default**: The image compression will be preserved as it is in the original document. - - **FlateDecode**: The images will be encoded with a FlateDecode filter. - - **DCTDecode**: Compresses data using a DCT (discrete cosine transform) technique based on the JPEG standard. +|Property|Description| +|----|----| +|**DocumentInfo**|A property of type [RadFixedDocumentInfo](https://docs.telerik.com/devtools/document-processing/api/Telerik.Windows.Documents.Fixed.Model.RadFixedDocumentInfo.html), intended to hold additional information about the document. The RadFixedDocumentInfo class allows you to set the title, author and description of the document.| +|**ImageQuality**|This property is of type [ImageQuality]({%slug radpdfprocessing-concepts-imagequality%}) and gets or sets the default image quality when exporting images to PDF. The default value is *High*. The value of this property is overridden when specifying the ImageQuality in ImageSource constructor or when creating [ImageSource]({%slug radpdfprocessing-model-imagesource%}) from EncodedImageData. The quality of the images reflects the size of the PDF file. The higher the quality, the bigger the document size is.| +|**ImageCompression**|Gets or sets the image compression type. The possible values are:
- **None**: No compression will be used.
- **Default**: The image compression will be preserved as it is in the original document.
- **FlateDecode**: The images will be encoded with a FlateDecode filter.
- **DCTDecode**: Compresses data using a DCT (discrete cosine transform) technique based on the JPEG standard.| +|**WriteAnnotations**|A boolean property indicating whether the annotations should be included in the exported document.| +|**StreamCompression**|Gets or sets the content stream compression type. Possible Values are:
- **None**: The content streams won't be encoded.
- **FlateDecode**: Compresses data using the zlib/deflate compression method.| -* **WriteAnnotations**: A boolean property indicating whether the annotations should be included in the exported document. +When merging documents' pages using the PdfStreamWriter the Form Fields may be duplicated. As of **Q2 2025** the **PdfStreamWriterSettings** offers the **MergedFieldNameResolving** event which occurs when trying to resolve conflicts between the fields names while merging instances with duplicated names: -* **StreamCompression**: Gets or sets the content stream compression type. Possible Values are: - - **None**: The content streams won't be encoded. - - **FlateDecode**: Compresses data using the zlib/deflate compression method. + > The XAML SDK repository on GitHub contains examples showing the capabilities of PdfStreamWriter: > diff --git a/libraries/radpdfprocessing/model/actions/gotor-actions.md b/libraries/radpdfprocessing/model/actions/gotor-actions.md new file mode 100644 index 00000000..3fc8f39b --- /dev/null +++ b/libraries/radpdfprocessing/model/actions/gotor-actions.md @@ -0,0 +1,38 @@ +--- +title: GoToR Actions +description: RadPdfProcessing provides support for GoToR actions. +page_title: GoToR Actions +slug: radpdfprocessing-model-actions-gotor +tags: gotor, go to r, action, pdf, processing +published: True +position: 4 +--- + +# GoToR Actions + +As of **Q2 2025** RadPdfProcessing provides **partial** support for **GoToR actions**. A *remote go-to* action is similar to an ordinary go-to action but jumps to a destination in another PDF file instead of the current file. The **GoToRAction** class offers the following public properties: + +|Property|Description| +|----|----| +|**File**| Gets or sets the remote File for the action.| +|**OpenInNewWindow**|Gets or sets a value indicating whether to open the destination document in a new window. True if the document should be open in a new window, otherwise false.| +|**Destination**|Gets or sets the named destination for the action.| + +>caution Currently, RadPdfProcessing provides support **only** for preserving the GoToR actions during import/export operations. + +>note Remote go-to actions cannot be used with embedded files. + +### Adding a GoToR Action to a Document + +The following example shows how to create a PDF document and add a **GoToRAction** to a [Link annotation]({%slug radpdfprocessing-model-annotations-links%}) that opens another PDF document in a new window: + +>important Navigating to a specific destination is not supported with the current implementation. + + + +## See Also + +* [Links]({%slug radpdfprocessing-model-annotations-links%}) +* [Actions]({%slug radpdfprocessing-model-actions%}) +* [Annotations]({%slug radpdfprocessing-model-annotations-overview%}) +* [LaunchAction]({%slug radpdfprocessing-model-actions-launch%}) diff --git a/libraries/radpdfprocessing/model/actions/images/pdf-processing-create-launch-action.png b/libraries/radpdfprocessing/model/actions/images/pdf-processing-create-launch-action.png new file mode 100644 index 00000000..ab32c3f1 Binary files /dev/null and b/libraries/radpdfprocessing/model/actions/images/pdf-processing-create-launch-action.png differ diff --git a/libraries/radpdfprocessing/model/actions/launch-actions.md b/libraries/radpdfprocessing/model/actions/launch-actions.md new file mode 100644 index 00000000..368adde4 --- /dev/null +++ b/libraries/radpdfprocessing/model/actions/launch-actions.md @@ -0,0 +1,33 @@ +--- +title: Launch Actions +description: RadPdfProcessing provides support for Launch actions. +page_title: Launch Actions +slug: radpdfprocessing-model-actions-launch +tags: launch, action, pdf, processing +published: True +position: 3 +--- + +# Launch Actions + +As of **Q2 2025** RadPdfProcessing provides support for **Launch actions** that PDF viewer applications are expected to support. A launch action launches an application or opens or prints a document. The LaunchAction class offers the following public properties: + +|Property|Description| +|----|----| +|**File**| Gets or sets the remote File for the action.| +|**OpenInNewWindow**|Gets or sets a value indicating whether to open the destination document in a new window. True if the document should be open in a new window, otherwise false.| + +### Adding a Launch Action to a Document + +The following example shows how to create a PDF document and add a **LaunchAction** to a [Link annotation]({%slug radpdfprocessing-model-annotations-links%}) that opens another PDF document in a new window: + + + + ![Create LaunchAction](images/pdf-processing-create-launch-action.png) + +## See Also + +* [Links]({%slug radpdfprocessing-model-annotations-links%}) +* [Actions]({%slug radpdfprocessing-model-actions%}) +* [Annotations]({%slug radpdfprocessing-model-annotations-overview%}) +* [GoToRAction]({%slug radpdfprocessing-model-actions-gotor%}) diff --git a/libraries/radpdfprocessing/model/actions/overview.md b/libraries/radpdfprocessing/model/actions/overview.md index de0724a8..a647200c 100644 --- a/libraries/radpdfprocessing/model/actions/overview.md +++ b/libraries/radpdfprocessing/model/actions/overview.md @@ -12,27 +12,15 @@ position: 0 The abstract **Action** class defines a behavior for an [annotation]({%slug radpdfprocessing-model-annotations-overview%}). Action is inherited from the following classes: - -* [GoToAction]({%slug radpdfprocessing-model-annotations-links%}): Associates the action with a __Destination__. The GoToAction class exposes the following properties: - - * __Destination__: The associated destination. - * __NamedDestination__: The associated named destination. - - -* [UriAction]({%slug radpdfprocessing-model-annotations-links%}): Associates the action with an Uri. The UriAction class exposes the following properties: - - * __Uri__: The associated Uri. - * __IncludeMouseCoordinates__: Specifies whether to include the mouse coordinates as query parameters in the Uri. - -* [JavaScriptAction]({%slug radpdfprocessing-model-javascript-actions%}): Represents a JavaScript action which exposes the following property: - - * **Script**: Gets or sets the script. - -* [NamedAction]({%slug radpdfprocessing-model-actions-named-actions%}): Represents a named action which exposes the following property: - - * **NamedActionType**: The type of the action representing the menu item to be executed. - -* [ResetFormAction]({%slug radpdfprocessing-model-interactive-forms-resetting-form-fields%}): Represents an action that resets the specified [form fields]({%slug radpdfprocessing-model-interactive-forms-form-fields%}) in a document. +|Action Type|Description| +|----|----| +|[GoToAction]({%slug radpdfprocessing-model-annotations-links%})|Associates the action with a __Destination__. The GoToAction class exposes the following properties:
__Destination__: The associated destination.
__NamedDestination__: The associated named destination.| +|[UriAction]({%slug radpdfprocessing-model-annotations-links%})|Associates the action with an Uri. The UriAction class exposes the following properties:
__Uri__: The associated Uri.
__IncludeMouseCoordinates__: Specifies whether to include the mouse coordinates as query parameters in the Uri. | +|[JavaScriptAction]({%slug radpdfprocessing-model-javascript-actions%})|Represents a JavaScript action which exposes the following property:
**Script**: Gets or sets the script.| +|[NamedAction]({%slug radpdfprocessing-model-actions-named-actions%})|Represents a named action which exposes the following property:
**NamedActionType**: The type of the action representing the menu item to be executed.| +|[ResetFormAction]({%slug radpdfprocessing-model-interactive-forms-resetting-form-fields%})|Represents an action that resets the specified [form fields]({%slug radpdfprocessing-model-interactive-forms-form-fields%}) in a document. | +|[LaunchAction]({%slug radpdfprocessing-model-actions-launch%})|Represents an action which launches an application, usually to open a file. | +|[GoToRAction]({%slug radpdfprocessing-model-actions-gotor%})|(“Go-to remote”) Go to a destination in another document.| ## See Also diff --git a/libraries/radpdfprocessing/model/annotations/links.md b/libraries/radpdfprocessing/model/annotations/links.md index 332fda0e..8fd8d7f9 100644 --- a/libraries/radpdfprocessing/model/annotations/links.md +++ b/libraries/radpdfprocessing/model/annotations/links.md @@ -128,4 +128,6 @@ __Example 4__ demonstrates how to create an action of type __GoToAction__, assoc * [Link API Reference](https://docs.telerik.com/devtools/document-processing/api/Telerik.Windows.Documents.Fixed.Model.Annotations.Link.html) * [JavaScript Actions]({%slug radpdfprocessing-model-javascript-actions%}) * [Creating TableCells with GoToAction and UriAction]({%slug kb-create-table-cells%}) + * [LaunchAction]({%slug radpdfprocessing-model-actions-launch%}) + * [GoToRAction]({%slug radpdfprocessing-model-actions-gotor%}) diff --git a/libraries/radpdfprocessing/model/form.md b/libraries/radpdfprocessing/model/form.md index ac21a7fd..c05ab5a2 100644 --- a/libraries/radpdfprocessing/model/form.md +++ b/libraries/radpdfprocessing/model/form.md @@ -16,8 +16,25 @@ __Form__ is a content element, which contains a form source and represents a For * [Form Properties](#form-properties) +## Public API -## Creating and Inserting a Form +| **Property** | **Description** | +|-----------------------|-------------------------------------------------------------------------------------------------| +| **FormSource** | Specifies the content that will be visualized in the Form object. It is of type [**FormSource**]({%slug radpdfprocessing-model-formsource-overview%}). | +| **Clipping** | Gets or sets the clipping of the form object. | +| **Width** | The width of the form. | +| **Height** | The height of the form. | +| **AlphaConstant** | Specifies the constant shape or constant opacity value to be used for nonstroking operations. | +| **StrokeAlphaConstant** | Specifies the constant shape or constant opacity value to be used for stroking operations. | +| **Position** | The [Position]({%slug radpdfprocessing-concepts-position%}) of the form inside the __IContainerElement__. | +| **Parent** | Allows you to obtain the parent page of the form. | + +| **Method** | **Description** | +|-----------------------|-------------------------------------------------------------------------------------------------| +| **Clone** (_since Q2 2025_) | Creates a deep copy of this document element. | + + +### Creating and Inserting a Form The **Form** class exposes a default public constructor to allow you create instances of it. __Form__ is a content element and you can add such an object to the __Content__ collection of an __IContainerElement__ such as [RadFixedPage]({%slug radpdfprocessing-model-radfixedpage%}). @@ -49,26 +66,9 @@ __Example 2__ demonstrates how to use one of the factory methods of the __Conten >You can add content to the form by setting its FormSource property. The API allows you also to directly pass the FormSource to a method which will automatically generate a form in the document content. For more information on this topic, check the [FormSource]({%slug radpdfprocessing-model-formsource-overview%}) article. -## Form Properties - -You can modify a __Form__ element using the properties the class exposes. The properties are listed below. - - -* __FormSource__: Specifies the content that will be visualized in the Form object. It is of type [**FormSource**]({%slug radpdfprocessing-model-formsource-overview%}). - -* __Clipping__: Gets or sets the clipping of the form object. - -* __Width__: The width of the form. - -* __Height__: The height of the form. - -* __AlphaConstant__: Specifying the constant shape or constant opacity value to be used for nonstroking operations. - -* __StrokeAlphaConstant__: Specifying the constant shape or constant opacity value to be used for nonstroking operations. - -* __Position__: The [Position]({%slug radpdfprocessing-concepts-position%}) of the form inside the __IContainerElement__. +### Modifying Form Properties -* __Parent__: Allows you to obtain the parent page of the form. +You can modify a __Form__ element using the properties the class exposes. The properties are listed in the [Public API](#public-api) section. #### __[C#] Example 3: Modify Form properties__ diff --git a/libraries/radpdfprocessing/model/image.md b/libraries/radpdfprocessing/model/image.md index cbd6986c..583dda66 100644 --- a/libraries/radpdfprocessing/model/image.md +++ b/libraries/radpdfprocessing/model/image.md @@ -11,15 +11,24 @@ position: 4 **Image** is a content element, which contains an [ImageSource]({%slug radpdfprocessing-model-imagesource%}) and represents an image. It can be added in the **Content** collection of a **IContainerElement** such as [RadFixedPage]({%slug radpdfprocessing-model-radfixedpage%}). -## Working With an Image +## Public API -You can edit an __Image__ element using the properties the class exposes. The properties are listed below. +| **Property** | **Description** | +|-----------------------|-------------------------------------------------------------------------------------------------| +| **ImageSource** | Specifies the [ImageSource]({%slug radpdfprocessing-model-imagesource%}) that will be visualized in the Image object. | +| **Width** | The width of the image. | +| **Height** | The height of the image. | +| **Position** | The [Position]({%slug radpdfprocessing-concepts-position%}) of the image inside the **IContainerElement**. | +| **AlphaConstant** | Specifies the constant shape or constant opacity value to be used for nonstroking operations. | -* __ImageSource__: Specifies the [ImageSource]({%slug radpdfprocessing-model-imagesource%}) that will be visualized in the Image object. -* __Width__: The width of the image. -* __Height__: The height of the image. -* __Position__: The [Position]({%slug radpdfprocessing-concepts-position%}) of the image inside the __IContainerElement__. -* __AlphaConstant__: Specifying the constant shape or constant opacity value to be used for nonstroking operations. +| **Method** | **Description** | +|-----------------------|-------------------------------------------------------------------------------------------------| +| **GetBitmapSource** (_.NET Standard_) | Creates a [BitmapSource](https://docs.microsoft.com/en-us/dotnet/api/system.windows.media.imaging.bitmapsource) from the image element.| +| **Clone** (_since Q2 2025_) | Creates a deep copy of this document element. | + +### Working With an Image + +You can edit an __Image__ element using the properties the class exposes. The properties are listed in the [Public API](#public-api) section. >note As of **Q3 2024** RadPdfProcessing provides support for SVG (vector graphics image format): [Adding SVG into a Document]({%slug radpdfprocessing-model-formsource-svg%}). diff --git a/libraries/radpdfprocessing/model/path.md b/libraries/radpdfprocessing/model/path.md index b44b7dcf..396ae695 100644 --- a/libraries/radpdfprocessing/model/path.md +++ b/libraries/radpdfprocessing/model/path.md @@ -18,7 +18,30 @@ __Path__ is a content element that represents series of connected lines and curv * [Modifying a Path](#modifying-a-path) -## Inserting a Path +## Public API + +| **Property** | **Description** | +|-----------------------|-------------------------------------------------------------------------------------------------| +| **Fill** | The color that is used to fill the path. The default value is Black. | +| **Stroke** | The color that is used to stroke the path. The default value is Black. | +| **IsFilled** | Specifies whether the path should be filled. | +| **IsStroked** | Specifies whether the path should be stroked. | +| **StrokeThickness** | The width of the stroke outline. | +| **StrokeLineCap** | Specifies the shape, which is used at the ends of open paths when they are stroked. It can have one of the following values:
**Flat**Flat line cap.
**Round**Round line cap.
**Square**Square line cap.
| +| **StrokeLineJoin** | Specifies the shape to be used at the corners of paths that are stroked. Join styles are significant only at the points where consecutive segments of a path connect at an angle. Available options:
**Bevel**Produces a diagonal corner.
**Miter**Produces a sharp corner. If the segments meet at too sharp an angle, a bevel join is used instead.
**Round**Produces a smooth, circular arc between the lines.
| +| **StrokeDashArray** | The pattern of dashes and gaps used to stroke paths. | +| **StrokeDashOffset** | The distance from the start of a line to the beginning of a dash pattern. | +| **AlphaConstant** | Specifies the constant shape or constant opacity value to be used for nonstroking operations. | +| **StrokeAlphaConstant** | Specifies the constant shape or constant opacity value to be used for stroking operations. | +| **MiterLimit** | The limit of the thickness of the join on a mitered corner. | +| **Geometry** | The shape to be drawn. More information about geometries is available [here]({%slug radpdfprocessing-concepts-geometry%}). | +| **Position** | Specifies the position of the path. | + +| **Method** | **Description** | +|-----------------------|-------------------------------------------------------------------------------------------------| +| **Clone** (_since Q2 2025_) | Creates a deep copy of this document element. | + +### Inserting a Path __Path__ is a content element that is designed to be added in the __Content__ collection of an __IContainerElement__ such [RadFixedPage]({%slug radpdfprocessing-model-radfixedpage%}). There are several approaches, which you can adopt to achieve that. @@ -34,8 +57,6 @@ __Example 1__ shows how you can create a Path, assign a predefined Geometry to i container.Content.Add(path); {{endregion}} - - __Example 2__ demonstrates how to use one of the factory methods of the __ContentElementCollection__ that create a new path and insert it into the document. @@ -47,69 +68,13 @@ __Example 2__ demonstrates how to use one of the factory methods of the __Conten {{endregion}} - >There are other methods that allow adding a path to a document. They could be used through the [FixedContentEditor class]({%slug radpdfprocessing-editing-fixedcontenteditor%}). -## Modifying a Path +### Modifying a Path -You can modify a __Path__ element using the properties the class exposes. The properties are listed below. +You can modify a __Path__ element using the properties the class exposes. The properties are listed listed in the [Public API](#public-api) section. - -* __Fill__: The color that is used to fill the path. The default value is Black. - - -* __Stroke__: The color that is used to stroke the path. The default value is Black. - - -* __IsFilled__: Specifies whether the path should be filled. - - -* __IsStroked__: Specifies whether the path should be stroked. - - -* __StrokeThickness__: The width of the stroke outline. - - -* __StrokeLineCap__: Specifies the shape, which is used at the ends of open paths when they are stroked. - - - * __Flat__: Flat line cap. - - * __Round__: Round line cap. - - * __Square__: Square line cap. - - -* __StrokeLineJoin__: Specifies the shape to be used at the corners of paths that are stroked. Join styles are significant only at the points where consecutive segments of a path connect at an angle. - - - * __Bevel__: Produces a diagonal corner. - - - * __Miter__: Produces a sharp corner. If the segments meet at too sharp angle, a bevel join is used instead. - - - * __Round__: Produces a smooth, circular arc between the lines. - - -* __StrokeDashArray__: The pattern of dashes and gaps used to stroke paths. - - -* __StrokeDashOffset__: The distance from the start of a line to the beginning of a dash pattern. - - -* __AlphaConstant__: Specifying the constant shape or constant opacity value to be used for nonstroking operations. - - -* __StrokeAlphaConstant__: Specifying the constant shape or constant opacity value to be used for nonstroking operations. - - -* __MiterLimit__: The limit of the thickness of the join on a mitered corner. - - -* __Geometry__: The shape to be drawn. More information about geometries is available [here]({%slug radpdfprocessing-concepts-geometry%}). - #### __[C#] Example 3: Modifying Path properties__ {{region cs-radpdfprocessing-model-path_2}} diff --git a/libraries/radpdfprocessing/model/textfragment.md b/libraries/radpdfprocessing/model/textfragment.md index eaf02b73..f84f1453 100644 --- a/libraries/radpdfprocessing/model/textfragment.md +++ b/libraries/radpdfprocessing/model/textfragment.md @@ -16,7 +16,37 @@ position: 3 * [Modifying a TextFragment](#modifying-a-textfragment) -## Creating a TextFragment +## Public API + +| **Property** | **Description** | +|-----------------------|-------------------------------------------------------------------------------------------------| +| **CharacterSpacing** | The spacing between the characters in the text. | +| **WordSpacing** | The spacing between the words in the text. (*Only space character (Unicode 0x32) is considered a word break in RadPdfProcessing's document model.*) | +| **HorizontalScaling** | The horizontal scaling that is applied to the characters. | +| **Font** | The font that is used to draw the text. | +| **FontSize** | The font size. The measurement unit used for font size is [Device Independent Pixels]({%slug device-independent-pixels%}) (DIPs). You can convert it to points or other units using the [Unit](https://docs.telerik.com/devtools/document-processing/api/Telerik.Windows.Documents.Media.Unit.html) class. | +| **RenderingMode** | Enumeration representing the way the text should be rendered. It can have one of the following values:
**Fill**Fill text (the default value).
**Stroke**Stroke text.
**FillAndStroke**Fill, then stroke text.
**None**Neither fill nor stroke text (invisible).
**FillAndAddToClippingPath**Fill text and add to path for clipping (see above).
**StrokeAndAddToClippingPath**Stroke text and add to path for clipping.
**FillStrokeAndAddToClippingPath**Fill, then stroke text and add to path for clipping
**AddToClippingPath**Add text to path for clipping.
| +| **TextRise** | Specifies the distance, in unscaled text space units, to move the baseline up or down from its default location. | +| **Fill** | The color that is used to fill the text. The default value is Black. | +| **Stroke** | The color that is used to stroke text. The default value is Black. | +| **StrokeThickness** | The width of the stroke line. | +| **StrokeLineCap** | Specifies the shape, which is used at the ends of open paths, used to draw a letter, when they are stroked. It can have one of the following values:
**Flat**Flat line cap.
**Round**Round line cap.
**Square**Square line cap.
| +| **StrokeLineJoin** | Specifies the shape to be used at the corners of paths that are stroked. Join styles are significant only at the points where consecutive segments of a path connect at an angle. Available options:
**Bevel**Produces a diagonal corner.
**Miter**Produces a sharp corner. If the segments meet at too sharp an angle, a bevel join is used instead.
**Round**Produces a smooth, circular arc between the lines.
| +| **StrokeDashArray** | The pattern of dashes and gaps used to stroke paths. | +| **StrokeDashOffset** | The distance from the start of a line to the beginning of a dash pattern. | +| **AlphaConstant** | Specifies the constant shape or constant opacity value to be used for nonstroking operations. | +| **StrokeAlphaConstant** | Specifies the constant shape or constant opacity value to be used for stroking operations. | +| **MiterLimit** | The limit of the thickness of the join on a mitered corner. | +| **Text** | Represents the text that is drawn. | +| **Position** | The [Position]({%slug radpdfprocessing-concepts-position%}) where the text element is drawn. | + +| **Method** | **Description** | +|-----------------------|-------------------------------------------------------------------------------------------------| +| **Clone** (_since Q2 2025_) | Creates a deep copy of this document element. | + +>note If you want to use a font, that is not part of the [standard fonts]({%slug radpdfprocessing-concepts-fonts%}#standard-fonts), you can register it using the [RegisterFont()]({%slug radpdfprocessing-concepts-fonts%}#registering-a-font) method of the FontRepository static class. + +### Creating a TextFragment **TextFragment** is a content element that can be added to the **Content** collection of an **IContainerElement** such as [RadFixedPage]({%slug radpdfprocessing-model-radfixedpage%}). There are several approaches that can be adopted: @@ -37,34 +67,10 @@ position: 3 >The '\r' and '\n' characters don't have the usual meaning of *"go to next line"* when they are inserted into a PDF document and you cannot simply insert text, containing these characters, to produce multiline text. Instead, you should split the text and insert it line by line. An alternative approach is to use the [RadFixedDocumentEditor]({%slug radpdfprocessing-editing-radfixeddocumenteditor%}) which allows you to create a document in a flow-like manner. +### Modifying a TextFragment -## Modifying a TextFragment - -TextFragment exposes the following properties that can modify the look of the represented text: - -|Property|Description| -|----|----| -|**CharacterSpacing**|The spacing between the characters in the text.| -|**WordSpacing**|The spacing between the words in the text. (*Only space character (Unicode 0x32) is considered a word break in RadPdfProcessing's document model.*)| -|**HorizontalScaling**|The horizontal scaling that is applied to the characters.| -|**Font**|The font that is used to draw the text.| -|**FontSize**|The font size. The measurement unit used for font size is [Device Independent Pixels]({%slug device-independent-pixels%}) (DIPs). You can convert it to points or other units using the [Unit](https://docs.telerik.com/devtools/document-processing/api/Telerik.Windows.Documents.Media.Unit.html) class.| -|**RenderingMode**|Enumeration representing the way the text should be rendered. It can have one of the following values:
**Fill**Fill text (the default value).
**Stroke**Stroke text.
**FillAndStroke**Fill, then stroke text.
**None**Neither fill nor stroke text (invisible).
**FillAndAddToClippingPath**Fill text and add to path for clipping (see above).
**StrokeAndAddToClippingPath**Stroke text and add to path for clipping.
**FillStrokeAndAddToClippingPath**Fill, then stroke text and add to path for clipping
**AddToClippingPath**Add text to path for clipping.
| -|**TextRise**|Specifies the distance, in unscaled text space units, to move the baseline up or down from its default location.| -|**Fill**|The color that is used to fill the text. The default value is Black.| -|**Stroke**|The color that is used to stroke text. The default value is Black.| -|**StrokeThickness**|The width of the stroke line.| -|**StrokeLineCap**|Specifies the shape, which is used at the ends of open paths, used to draw a letter, when they are stroked. It can have one of the following values:
**Flat**Flat line cap.
**Round**Round line cap.
**Square**Square line cap.
| -|**StrokeLineJoin**|Specifies the shape to be used at the corners of paths that are stroked. Join styles are significant only at the points where consecutive segments of a path connect at an angle. Available options:
**Bevel**Produces a diagonal corner.
**Miter**Produces a sharp corner. If the segments meet at too sharp an angle, a bevel join is used instead.
**Round**Produces a smooth, circular arc between the lines.
| -|**StrokeDashArray**|The pattern of dashes and gaps used to stroke paths.| -|**StrokeDashOffset**|The distance from the start of a line to the beginning of a dash pattern.| -|**AlphaConstant**|Specifying the constant shape or constant opacity value to be used for nonstroking operations.| -|**MiterLimit**|The limit of the thickness of the join on a mitered corner.| -|**Text**|Represents the text that is drawn.| -|**Position**|The [Position]({%slug radpdfprocessing-concepts-position%}) where the text element is drawn.| +You can modify a **TextFragment** element using the properties listed in the [Public API](#public-api) section. ->note If you want to use a font, that is not part of the [standard fonts]({%slug radpdfprocessing-concepts-fonts%}#standard-fonts), you can register it using the [RegisterFont()]({%slug radpdfprocessing-concepts-fonts%}#registering-a-font) method of the FontRepository static class. - #### __[C#] Example 2: Modifying TextFragment's properties__ @@ -73,7 +79,6 @@ TextFragment exposes the following properties that can modify the look of the re ![Modified TextFragments in PdfProcessing](images/radpdfprocessing-model-modified-textfragments.png) - ## See Also * [RadFixedPage]({%slug radpdfprocessing-model-radfixedpage%}) diff --git a/libraries/radziplibrary/features/update-ziparchive.md b/libraries/radziplibrary/features/update-ziparchive.md index 9e3eb31b..5494787b 100644 --- a/libraries/radziplibrary/features/update-ziparchive.md +++ b/libraries/radziplibrary/features/update-ziparchive.md @@ -167,6 +167,18 @@ In order to update an existing entry in the ZIP archive, you should perform the End If {{endregion}} +## Copy Entry + +Starting with the **Q2 2025** release, the __RadZipLibrary__ introduces a new extension method `CopyTo` for the `Stream` class. This method allows you to copy data from one stream to another with an optional timeout parameter, providing more control over long-running operations. This is particularly useful when working with large files in ZIP archives. + +The following example demonstrates how to use the `CopyTo` method to copy the contents of a large file from a ZIP archive to a memory stream with a specified timeout. + +#### __[C#] Example 5: Copy entry with timeout__ + + + +This method ensures that the operation will not hang indefinitely, making it a valuable addition for scenarios involving large files or limited resources. + ## See Also diff --git a/libraries/radziplibrary/features/zip-extensions.md b/libraries/radziplibrary/features/zip-extensions.md index bcd78a9b..8cecff01 100644 --- a/libraries/radziplibrary/features/zip-extensions.md +++ b/libraries/radziplibrary/features/zip-extensions.md @@ -19,16 +19,15 @@ In this article you will find the classes and their members. ## The ZipFile class -With the __ZipFile__ class you could take advantage of static methods, which will give you the ability to create, extract or open zip archives with only one line of code. +With the __ZipFile__ class, you can utilize static methods to create, extract, or open zip archives with minimal code. Starting with the **Q2 2025** release, some methods now include an additional optional parameter `(TimeSpan? timeout)`. The older overloads of these specific methods, which do not include this parameter, are now obsolete. -* __[ZipArchiveEntry]({%slug radziplibrary-update-ziparchive%}) CreateEntryFromFile(this ZipArchive destination, string sourceFileName, string entryName)__ – Archives a file by compressing it and adding it to the zip archive. It has two more overloads, which allow you to specify the __CompressionLevel__ or __CompressionSettings__ of the __ZipEntry__. +* **[ZipArchiveEntry]({%slug radziplibrary-update-ziparchive%}) CreateEntryFromFile(this ZipArchive destination, string sourceFileName, string entryName, _TimeSpan? timeout_)** – Archives a file by compressing it and adding it to the zip archive. You can also specify the __CompressionLevel__ or __CompressionSettings__ of the __ZipEntry__ using other overloads. -* __void CreateFromDirectory(string sourceDirectoryName, string destinationArchiveFileName)__: Creates a zip archive that contains the files and directories from the specified directory. This method has few overloads to set different settings of the entry. - -* __void ExtractToDirectory(string sourceArchiveFileName, string destinationDirectoryName)__: Extracts all the files in the specified zip archive to a directory on the file system. +* **void CreateFromDirectory(string sourceDirectoryName, string destinationArchiveFileName, _TimeSpan? timeout_)**: Creates a zip archive containing the files and directories from the specified directory. Additional overloads allow you to configure various settings for the entries. +* **void ExtractToDirectory(string sourceArchiveFileName, string destinationDirectoryName, _TimeSpan? timeout_)**: Extracts all the files in the specified zip archive to a directory on the file system. -* __void ExtractToFile(this ZipArchiveEntry source, string destinationFileName)__: Extracts an entry in the zip archive to a file. With the additional overload you could specify whether to overwrite an existing file that has the same name as the destination file or not. +* **void ExtractToFile(this ZipArchiveEntry source, string destinationFileName, _TimeSpan? timeout_)**: Extracts an entry in the zip archive to a file. You can also specify whether to overwrite an existing file with the same name as the destination file. * __ZipArchive Open(string archiveFileName, ZipArchiveMode mode)__: Opens a zip archive at the specified path and in the specified mode. Another overload allows specifying the encoding to use when reading or writing entry names in this archive. Specify a value for this parameter only when an encoding is required for interoperability with zip archive tools and libraries that do not support UTF-8 encoding for entry names.