Stirling-PDF/frontend/src/hooks/useThumbnailGeneration.ts
Reece Browne 922bbc9076
Stirling 2.0 (#3928)
# Description of Changes

<!--

File context for managing files between tools and views
Optimisation for large files
Updated Split to work with new file system and match Matts stepped
design closer

-->

---

## Checklist

### General

- [ ] I have read the [Contribution
Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md)
- [ ] I have read the [Stirling-PDF Developer
Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md)
(if applicable)
- [ ] I have read the [How to add new languages to
Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md)
(if applicable)
- [ ] I have performed a self-review of my own code
- [ ] My changes generate no new warnings

### Documentation

- [ ] I have updated relevant docs on [Stirling-PDF's doc
repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/)
(if functionality has heavily changed)
- [ ] I have read the section [Add New Translation
Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md#add-new-translation-tags)
(for new translation tags only)

### UI Changes (if applicable)

- [ ] Screenshots or videos demonstrating the UI changes are attached
(e.g., as comments or direct attachments in the PR)

### Testing (if applicable)

- [ ] I have tested my changes locally. Refer to the [Testing
Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md#6-testing)
for more details.

---------

Co-authored-by: Anthony Stirling <77850077+Frooodle@users.noreply.github.com>
2025-07-16 17:53:50 +01:00

56 lines
1.5 KiB
TypeScript

import { useCallback } from 'react';
import { thumbnailGenerationService } from '../services/thumbnailGenerationService';
/**
* Hook for tools that want to use thumbnail generation
* Tools can choose whether to include visual features
*/
export function useThumbnailGeneration() {
const generateThumbnails = useCallback(async (
pdfArrayBuffer: ArrayBuffer,
pageNumbers: number[],
options: {
scale?: number;
quality?: number;
batchSize?: number;
parallelBatches?: number;
} = {},
onProgress?: (progress: { completed: number; total: number; thumbnails: any[] }) => void
) => {
return thumbnailGenerationService.generateThumbnails(
pdfArrayBuffer,
pageNumbers,
options,
onProgress
);
}, []);
const addThumbnailToCache = useCallback((pageId: string, thumbnail: string) => {
thumbnailGenerationService.addThumbnailToCache(pageId, thumbnail);
}, []);
const getThumbnailFromCache = useCallback((pageId: string): string | null => {
return thumbnailGenerationService.getThumbnailFromCache(pageId);
}, []);
const getCacheStats = useCallback(() => {
return thumbnailGenerationService.getCacheStats();
}, []);
const stopGeneration = useCallback(() => {
thumbnailGenerationService.stopGeneration();
}, []);
const destroyThumbnails = useCallback(() => {
thumbnailGenerationService.destroy();
}, []);
return {
generateThumbnails,
addThumbnailToCache,
getThumbnailFromCache,
getCacheStats,
stopGeneration,
destroyThumbnails
};
}