Github Stirling Tools Stirling Pdf 1 Pdf Application On Getting Starte

Loading... Loading... Menu - app/core/src/main/java/stirling/software/SPDF/controller/api/converters/ConvertPDFToExcelController.java - app/core/src/main/java/stirling/software/SPDF/controller/api/converters/ConvertPDFToPDFA.java - app/core/src/main/java/stirling/software/SPDF/model/api/converters/PdfToPdfARequest.java - frontend/src/core/components/tools/convert/ConvertSettings.tsx - frontend/src/core/components/tools/convert/ConvertToEpubSettings.tsx - frontend/src/core/components/tools/convert/ConvertToPdfaSettings.tsx - frontend/src/core/constants/convertConstants.ts - frontend/src/core/constants/convertSupportedFornats.ts - frontend/src/core/contexts/FileContext.tsx - frontend/src/core/data/toolsTaxonomy.ts - frontend/src/core/hooks/tools/automate/useSuggestedAutomations.ts - frontend/src/core/hooks/tools/convert/useConvertOperation.ts - frontend/src/core/hooks/tools/convert/useConvertParameters.test.ts - frontend/src/core/hooks/tools/convert/useConvertParameters.ts - frontend/src/core/hooks/tools/shared/toolOperationHelpers.ts - frontend/src/core/i18n/config.ts - frontend/src/core/tests/convert/ConvertIntegration.test.tsx - frontend/src/core/tests/convert/ConvertSmartDetectionIntegration.test.tsx - frontend/src/core/tests/helpers/conversionEndpointDiscovery.ts - frontend/src/core/types/tool.ts - frontend/src/core/utils/toolErrorHandler.ts - frontend/src/core/utils/urlMapping.ts This page documents the conversion-related API endpoints and operations in Stirling-PDF. These endpoints handle transformations between PDFs, images, Office documents, HTML, and ebook formats. Stirling-PDF provides a comprehensive conversion matrix through a unified frontend interface and specialized backend controllers.

All conversion endpoints follow a consistent pattern using multipart form data. Endpoint Pattern: /api/v1/convert/{source-format}/{target-format} The system supports a wide array of formats, managed via a central configuration in the frontend and executed by specific backend services. Sources: - frontend/src/core/constants/convertConstants.ts101-162 - frontend/src/core/constants/convertSupportedFornats.ts1-21 The frontend uses a dynamic parameter system to route requests to the correct API endpoint based on the selected "From" and "To" extensions. Sources: - frontend/src/core/hooks/tools/convert/useConvertParameters.ts186-209 - frontend/src/core/hooks/tools/convert/useConvertOperation.ts48-111 - frontend/src/core/components/tools/convert/ConvertSettings.tsx70-84 Stirling-PDF supports converting standard PDFs to archival formats (PDF/A) and exchange formats (PDF/X).

Controller: ConvertPDFToPDFA.java Endpoint: POST /api/v1/convert/pdf/pdfa The conversion utilizes PDFBox to restructure the document and embed necessary metadata. - Color Profile: Embeds an ICC profile (sRGB2014.icc) to ensure device-independent color app/core/src/main/java/stirling/software/SPDF/controller/api/converters/ConvertPDFToPDFA.java106 - Metadata: Generates XMP metadata including PDFAIdentificationSchema app/core/src/main/java/stirling/software/SPDF/controller/api/converters/ConvertPDFToPDFA.java67-73 - Strict Mode: If enabled, the system uses VeraPDFService to verify the resulting file against PDF/A standards app/core/src/main/java/stirling/software/SPDF/controller/api/converters/ConvertPDFToPDFA.java104 Sources: - app/core/src/main/java/stirling/software/SPDF/controller/api/converters/ConvertPDFToPDFA.java100-148 - frontend/src/core/components/tools/convert/ConvertToPdfaSettings.tsx24-28 The "Smart Detection" feature automatically identifies file types and suggests the most appropriate conversion path. The system analyzes the extensions of uploaded files to set the smartDetectionType.

Sources: - frontend/src/core/hooks/tools/convert/useConvertParameters.ts214-280 - frontend/src/core/tests/convert/ConvertSmartDetectionIntegration.test.tsx114-148 Conversions between PDF and Office formats (Word, Excel, PowerPoint) are primarily handled by LibreOffice or specialized PDFBox extractors. For pdf → docx or pdf → txt, the system uses specialized controllers that leverage PDFBox's text extraction capabilities or external converters. Endpoints: - PDF to Word: /api/v1/convert/pdf/word frontend/src/core/constants/convertConstants.ts27 - PDF to Excel: /api/v1/convert/pdf/xlsx frontend/src/core/constants/convertConstants.ts31 - PDF to Text: /api/v1/convert/pdf/text frontend/src/core/constants/convertConstants.ts29 General document-to-PDF conversion uses the file-to-pdf endpoint, which acts as a catch-all for formats supported by LibreOffice.

Endpoint: POST /api/v1/convert/file/pdf frontend/src/core/constants/convertConstants.ts21 Sources: - frontend/src/core/constants/convertConstants.ts20-45 - frontend/src/core/hooks/tools/convert/useConvertOperation.ts62-67 Bidirectional conversion between PDFs and images/archives (CBZ/CBR). Converts PDF pages to image files (PNG, JPG, WebP, etc.). Endpoint: POST /api/v1/convert/pdf/img Parameters: imageFormat: Target format extension.singleOrMultiple: Whether to return a single merged image or a ZIP of separate pages.dpi: Rendering resolution frontend/src/core/hooks/tools/convert/useConvertOperation.ts57-61 - CBZ/CBR to PDF: Extracts images from the archive and merges them into a PDF. - PDF to CBZ/CBR: Renders PDF pages as images and packages them into the archive format.

Sources: - frontend/src/core/hooks/tools/convert/useConvertOperation.ts91-98 - frontend/src/core/constants/convertConstants.ts25-26 This hook manages the execution of conversion tasks. It handles the logic for determining if files should be processed individually or as a batch. Key Function: shouldProcessFilesSeparately() This function returns true for operations where each input file results in a distinct output (e.g., Office to PDF, PDF to Image) frontend/src/core/hooks/tools/convert/useConvertOperation.ts11-45 Manages the state of conversion settings, including: fromExtension andtoExtension validation against theCONVERSION_MATRIX.- Automatic detection of file types upon upload. - Resetting parameters to defaults when formats change.

Sources: - frontend/src/core/hooks/tools/convert/useConvertParameters.ts76-128 - frontend/src/core/hooks/tools/convert/useConvertParameters.ts130-150 The conversion system is verified through integration tests that mock the apiClient and verify FormData construction.

Key Tests: - PDF to PNG: Verifies correct parameters like dpi andcolorType are sent to/api/v1/convert/pdf/img frontend/src/core/tests/convert/ConvertIntegration.test.tsx123-202 - Smart Detection: Verifies that a.docx file correctly triggers a call to/api/v1/convert/file/pdf frontend/src/core/tests/convert/ConvertSmartDetectionIntegration.test.tsx114-148 Sources: Refresh this wiki - Conversion Operations - Overview - Conversion Matrix - Architecture - Conversion Request Flow - PDF to PDF/A and PDF/X - PDF/A Processing Logic - Smart Detection System - Detection Logic - Office and Document Conversions - PDF to Office (Word/Text) - Office to PDF - Image and Archive Conversions - PDF to Image - Archive Formats (Comic Books) - Frontend Implementation Details - useConvertOperation Hook - useConvertParameters Hook - Integration Testing

People Also Asked

• GitHub%20-%20Stirling-Tools/Stirling-PDF%3A%20%231%20PDF%20Application%20on...
• Getting%20Started%20%7C%20Stirling%20PDF
• Installation%20and%20Setup%20%7C%20Stirling-Tools/Stirling-PDF%20%7C%20DeepWiki
• GitHub%20-%20EvolvingSoftware/stirling-pdf%3A%20%231%20Locally%20hosted%20web...
• Getting%20Started%20%7C%20Stirling-Tools/Stirling-PDF%20%7C%20DeepWiki
• Installing%20Stirling-PDF%20for%20a%20suite%20of%20useful%20self-hosted...
• Stirling%20PDF%20%u2014%20Self-hosted%20PDF%20manipulation%20powerhouse
• Stirling%20Tools%20-%20GitHub