diff --git a/apdfl18/DotNet/APDFL18.0.5PlusP1b/DotNet/index.html b/apdfl18/DotNet/APDFL18.0.5PlusP1b/DotNet/index.html index 195a606c..60064cd1 100644 --- a/apdfl18/DotNet/APDFL18.0.5PlusP1b/DotNet/index.html +++ b/apdfl18/DotNet/APDFL18.0.5PlusP1b/DotNet/index.html @@ -180,9 +180,7 @@
-
-
For example, to deploy your .NET application from a Windows machine to a Linux machine:
-Change to the application directory and use the publish command:
-dotnet publish
-This will create a publish folder with dependencies for the program, which can vary depending on the sample.
-Sample deployment scripts can be found on GitHub. (The paths used in the scripts are meant as examples of where you would have your local resources actually stored relative to the project.)
-Run the deployment script that corresponds to the OS you want to deploy to.
-E.g., the script PublishToLinux.bat, will add the remaining dependencies to the publish folder.
-This will include the Linux_Dependencies.tar.gz file which needs to be decompressed along side the target application.
-The dependencies will depend on your deployment OS, e.g.:
Then the application can be run:
-dotnet MyApplication.dll
-Need Assistance Getting Started? Contact Evaluation Support | -
When creating a Font object from a name, if the found font is a Type0 font, an Identity encoding is used. Otherwise, it makes a font with the default encoding (MacRomanEncoding on Mac, WinAnsiEncoding elsewhere, or for Symbol fonts, their own custom encoding).
-When adding Text to a Page, the Library checks to see if the Text is representable in the font's encoding. If not, then it makes a Type0 font with an Identity-H encoding. For non-Type0 fonts, this may result in two versions of a font in the output document.
-The EmbedFonts() method of the Document class should be called before saving as a best practice.
-When saving, the Library enumerates all the fonts in the document, and makes sure that any required Unicode and Width information is created to ensure proper text extraction and display.
-When working with PDFString objects:
-They are stored within a PDF file encoded either in UTF-16BE or in PDFDocEncoding (an 8-bit encoding scheme that can encode all of ISO Latin-1).
-They can be created with an input string in either encoding. Most PDFString constructors will attempt to convert the data string to PDFDocEncoding if it can be converted without a loss of information; otherwise they will save it in UTF-16BE. If you want the string to be encoded in UTF-16BE even if it could be converted to PDFDocEncoding, use a PDFString constructor that takes the storedAsUTF16 argument, with that flag set to true.
-PDFString objects offer two properties for accessing their contents:
-Need Assistance Getting Started? Contact Evaluation Support | -
Built upon Adobe source code used for Acrobat, Datalogics Adobe PDF Library SDK provides stable, reliable code and the flexibility to develop with C# or VB (VB.NET) (interfaces are also available for C++ and Java). APDFL is the most complete SDK for PDF creation, manipulation and management. Best for enterprise/larger organizations of developers and independent software vendors (ISVs) who need to incorporate Adobe's PDF functionality into their own internal or external applications.
-Most of the code samples in APDFL are designed to demonstrate how an API works by completing a simple programming task.
-We assume a basic level of technical understanding of the PDF file format, individual sample category directory markdown files go into more details.
-Many of these sample programs automatically generate an output file or set of files. These output files, generally PDF or graphics files (JPG or BMP), are stored in the directory where the application has been run. If you run a sample program a second or third time, it will overwrite any output files that were created and stored earlier. However, if you run a sample program, generate a PDF output file, and then open that PDF file and try to run that sample program again, you will see an error message. The program will not be able to overwrite an existing output file if that file is currently open in another program.
-(Note: that the Forms Extension product and samples are available by talking to Datalogics Sales.)
-The SDK can be found at Nuget Gallery and installed using Visual Studio or any Nuget client.
-See Licensing for information on License Management.
-Samples can be found on GitHub.
-They can be built and run easily in an IDE such as Visual Studio 2022, Visual Studio 2022 for Mac, or VS Code.
-Otherwise, here are instructions for using dotnet instead:
-Change to the directory of the program you want to work with:
-cd ./Images/RasterizePage
-Build a sample project file using the Debug configuration using the dotnet program:
-dotnet build -c Debug ./RasterizePage.csproj
-If you want to build for Release, use this syntax instead:
-dotnet build -c Release ./RasterizePage.csproj
-Change to the directory your sample built its executable to:
-cd ./bin/Debug/net6.0/
-Run the application by specifying the .dll file (Note: the .dll file extension is the .NET executable for all platforms):
-dotnet ./RasterizePage.dll
-Note: Samples are setup to write their output files to the program's executable directory along with any other dependencies, such as SkiaSharp for Graphics.
-See our API Reference Guide to search for the API you need and find detailed information.
-Please contact evals.nosp@m.uppo.nosp@m.rt@da.nosp@m.talo.nosp@m.gics..nosp@m.com for assistance getting started.
-Need Assistance Getting Started? Contact Evaluation Support | -
To activate the free trial:
Alternatively, to use an activation key in code, the LibraryKey member of the Library class can be set to a valid activation key prior to instantiating the library.
-Library.LicenseKey = "xxxx-xxxx-xxxx-xxxx";
-Library lib = new Library();
-
-
-
License activation can instead make use of a user-defined Proxy Server and will attempt to automatically detect it on Windows.
-Otherwise, set the Environment Variable HTTP_PROXY to the hostname and port number separated by a colon.
-For example, to utilize the HTTP Proxy Server running on myproxyhost on port 8765:
-set HTTP_PROXY=myproxyhost:8765
-export HTTP_PROXY=myproxyhost:8765
-If your Proxy Server uses authentication, set the Environment Variable HTTP_PROXY_CREDENTIALS to the username and password, separated by a colon.
-For example, if your username is user and password is password:
-set HTTP_PROXY_CREDENTIAL=”user:password”
-export HTTP_PROXY_CREDENTIAL=”user:password”
-If you continue to have issues with licensing, please contact evals.nosp@m.uppo.nosp@m.rt@da.nosp@m.talo.nosp@m.gics..nosp@m.com for an offline key.
-Need Assistance Getting Started? Contact Evaluation Support | -
Sometimes PDF documents reference a Font that's not embedded and attempts to find such a Font on the OS will fail.
-The PDF Library looks in standard locations to find fonts on the OS. But some Linux distributions do not have fonts more commonly found on Windows platforms. A well-known solution is to use use the Microsoft Core TTF fonts. If your system doesn't have these they need to be installed for the fonts to be accessible.
-To install these for Debian/Ubuntu:
-sudo apt install ttf-mscorefonts-installer
-To install them for RedHat Enterprise Linux/CentOS:
-yum install curl cabextract xorg-x11-font-utils fontconfig
-rpm -i https://downloads.sourceforge.net/project/mscorefonts2/rpms/msttcorefonts-installer-2.6-1.noarch.rpm
-Need Assistance Getting Started? Contact Evaluation Support | -
PDFL .NET objects can be associated with a large amount of unmanaged memory which exert little memory pressure on the .NET runtime, which means there may be a long period before the garbage collector deletes these objects. The garbage collector is not aware of the size of the unmanaged or native objects in APDFL.
-Thus, there may be a delay before garbage collection happens, and the large amount of memory that is associated with objects no longer in use is freed.
-It is important then to release the unmanaged resources in APDFL as soon as a object is no longer in use. To do this, call the Dispose method.
-In C#, a using statement automatically calls Dispose():
-using (Page page = doc.GetPage(0)) {
-}
-Need Assistance Getting Started? Contact Evaluation Support | -
A default set of fonts for OCR processing is available, but you can add fonts from other languages to the CandidateFontNames member of the OCRParams object.
-If you want to use a different language, install the language package of interest from Nuget.
-E.g., to set the language for OCR to Chinese Simplified, install the Nuget package for it, then update the CandidateFontNames list to include it:
-List<string> newFontNames = new List<string>();
-foreach(string fontName in ocrParams.candidateFontNames) {
-newFontNames.Add(fontName);
-}
-newFontNames.Add("Chin"); //Chin.ttf is the name of the font file
-ocrParams.candidateFontNames = newFontNames;
Make sure you provide enough fonts to cover the expected languages and scripts that might appear in the images embedded in your source PDF documents. If you have PDF documents with images that feature text in multiple languages, supply fonts applicable to each of those languages, especially if more than one language appears within a single sentence or phrase. For example, an image might feature text written in the Korean alphabet but also featuring western (Arabic) numerals.
-The OCR processing engine will use the first font that it finds that can successfully render text drawn from a graphics image. If you are providing fonts for a Latin alphabet, set up OCR processing so that proportional fonts appear before non-proportional fonts.
-The quality of the output provided by the OCR engine depends on the fonts you choose. Decorative fonts, such as Zapf Chancery, generally provide poor results. Try to use standard block fonts that would appear in a novel or magazine instead.
-The OCR engine does not support languages where characters are not presented from left to right, including:
-The GetAvailableLanguages() method of the OCREngine class can be used to list the available languages and the IsLanguageAvailble() method can be used to check if a specific language file is available.
-Need Assistance Getting Started? Contact Evaluation Support | -
Releases are frequent and new samples, features, and improvements are constantly occurring, stay informed of the latest by reading the Release Notes.
--
Need Assistance Getting Started? Contact Evaluation Support | -
It's recommended that you include all of the files in the Resources directory with your application.
-Font files that cover most typical documents that are used besides OS fonts.
-Predefined mappings between character encodings and specific, predefined character identifier sets used during font handling.
-An options file for driving the XPS2PDF plugin.
-Color profiles utilized during color conversion.
-Unicode mappings utilized during font handling.
-Typographic files used for converting PDF to Office documents.
-These files are used for rendering, conversion, printing, and other operations. The Library will look for the Resources directory in a known location. However custom paths to the individual paths can be specified during the Library Initialization.
-Need Assistance Getting Started? Contact Evaluation Support | -
The Datalogics PDF Library includes a comprehensive set of APIs for your PDF manipulation needs.
-.NET | OS | Architecture | IDE |
---|---|---|---|
v6 or Higher | Windows | x64 | Visual Studio 2022 or Visual Studio Code |
v6 or Higher | Linux | x64 or ARM64 | Visual Studio Code |
v6 or Higher | macOS | x64 or ARM64 | Visual Studio 2022 for Mac or Visual Studio Code |
-
-
Need Assistance Getting Started? Contact Evaluation Support | -
When using Visual Studio for Mac for developement if your experience the System.ApplicationException:
-Failed to initialize locale
-Go to the Visual Studio menu.
-Select Preferences.
-Scroll to the bottom of the Preferences dialog, under the Other section.
-Select Terminal.
-Uncheck Enable integrated terminal.
-Press OK. Try running the application again.
If the problem persists:
-Go to the Project menu.
-Select Properties.
-Under the Run section, select Configurations.
-Select your active Configuration.
-Click the Add button and add the following variables and values:
-LC_ALL en_US.UTF-8
-LANG en_US.UTF-8
-Press OK. Try running the application again.
-