Umieszczanie obrazu w PDF
Dodaj obraz umieszcza obraz PNG, JPEG lub SVG na PDF w podanej pozycji x i y, w punktach od lewego dolnego rogu. Nakłada go tylko na pierwszą stronę, chyba że wybierzesz każdą stronę.
Przeciągnij pliki tutaj albo kliknij, żeby wybrać
Obsługiwane: PDF · do 500.0 MB na plik · maks. 20 plików naraz
Możesz też wkleić plik przez Ctrl/Cmd+V lub z menu schowka.
Dodaj obraz nakłada `imageFile` w punkcie `(x,y)` w punktach PDF (początek w lewym dolnym rogu). Pliki rastrowe stają się XObject Flate. SVG jest drukowany przez WeasyPrint, a potem importowany jako Form. `everyPage=true` nakłada obraz na wszystkie strony; w przeciwnym razie tylko na pierwszą.
Pobrany plik nazywa się `overlayed_{base}.pdf`. Pliki chronione hasłem są odblokowywane za Ciebie na tej stronie, gdy tylko wpiszesz hasło; wywołujący API najpierw uruchamiają Usuń hasło.
Nie ma pola skali; rozmiar to natywna szerokość i wysokość obrazu w macierzy `cm`. Przezroczystość nie jest parametrem.
Do znaku tekstowego użyj Dodaj pieczątkę. Do innego PDF jako warstwy użyj Nałóż PDF.
Obraz jest rysowany na wierzchu istniejącej zawartości strony, na ostatniej pozycji w kolejności rysowania. Nie zastępuje ani nie ukrywa niczego pod spodem na poziomie struktury: tekst i grafika pod spodem nadal są w pliku, tylko zasłonięte tam, gdzie obraz jest kryjący. Dlatego nadaje się do logo w wolnym rogu, ale nie do zasłaniania poufnej treści, do czego potrzebne jest prawdziwe narzędzie do zaciemniania.
Położenie to pojedyncza kotwica. `x` i `y` podają lewy dolny róg obrazu w punktach od lewego dolnego rogu strony, a obraz rozciąga się stamtąd w prawo i w górę. Rozmiaru nie wybierasz: raster jest umieszczany w proporcji jeden punkt PDF na piksel, więc PNG 300 na 100 pikseli zajmuje 300 na 100 punktów, czyli około 4,2 na 1,4 cala. Strona Letter ma 612 na 792 punkty, więc wszystko znacznie szersze wyjdzie poza stronę. Zmień rozmiar obrazu na żądany przed przesłaniem.
Obrazy rastrowe (PNG i JPEG) są dekodowane i zapisywane ponownie jako 8-bitowe RGB. Przezroczystość nie jest zachowywana, więc PNG z przezroczystym tłem może pokazać jednolity blok w miejscu przezroczystego obszaru. Jeśli potrzebujesz logo, które wtapia się w stronę, wyeksportuj je najpierw z białym lub pasującym tłem albo umieść tylko na białym obszarze.
`everyPage=false` umieszcza obraz tylko na stronie 1; `everyPage=true` powtarza go w tych samych współrzędnych na każdej stronie. Strony o różnych rozmiarach dostają tę samą kotwicę, więc w pliku o mieszanych rozmiarach znak może wylądować w różnych miejscach wizualnie. Nie można wybrać tylko stron 2 i 5; jeśli tego potrzebujesz, podziel plik, dodaj obraz do wybranej części i połącz z powrotem.
Jeśli przesyłanie się nie powiedzie, zwykle powodem jest plik, który nie jest obrazem rozumianym przez dekoder, co zwraca komunikat o nieobsługiwanym typie pliku, albo brak `imageFile`. Wyeksportuj obraz ponownie jako PNG lub JPEG i spróbuj jeszcze raz.
Funkcje
- XObject rastrowy albo Form SVG przez WeasyPrint
- `x`,`y` w punktach; pierwsza strona lub każda
- Bez kontroli przezroczystości ani skali
- Anonimowe API: /api/v1/misc/add-image
Kiedy tego użyć
- Położyć logo PNG na stronie 1
- Powtórzyć znak w stałym punkcie na każdej stronie
- Wrzucić SVG przez WeasyPrint, gdy wystarczy dokładność druku
- Dodać obraz zeskanowanego podpisu w linii podpisu jednostronicowej umowy
- Umieścić pieczęć firmy w stopce każdej strony raportu o jednolitych rozmiarach stron
Jak dodać obraz do PDF?
- Prześlij PDF i obraz (PNG, JPEG lub SVG).
- Ustaw x i y w punktach od lewego dolnego rogu.
- Wybierz tylko pierwszą stronę albo każdą.
- Pobierz overlayed_*.pdf i sprawdź kotwicę.
Ograniczenia i przypadki brzegowe
- Bez pól skali/przezroczystości
- Tylko jeden punkt kotwiczenia: bez wyboru stron poza pierwszą stroną lub każdą
- Nie usuwa ani nie ukrywa treści pod obrazem
- Ogromny raster staje się ogromnym umieszczeniem w PDF
- Przezroczyste obszary PNG nie są zachowywane: obrazy są konwertowane do RGB, więc przezroczyste piksele przyjmują kolor zapisany pod spodem, często czarny
- Pliki chronione hasłem wymagają hasła; wywołujący API najpierw uruchamiają Usuń hasło
- Limit przesyłania na tej stronie: 500 MB na plik, wysyłane porcjami powyżej około 95 MB. Treść pojedynczego bezpośredniego żądania API jest ograniczona do 100 MB.
Przykłady
- x=0 y=0 kładzie lewy dolny róg obrazu w lewym dolnym rogu strony
- Przy everyPage=false strona 2 i kolejne nie zmieniają się
- Logo PNG 200 na 80 pikseli z x=400, y=20 i everyPage=true leży w prawym dolnym rogu każdej strony formatu Letter, ma 200 punktów szerokości, a pobrany plik nazywa się overlayed_report.pdf dla pliku wejściowego report.pdf
- Zdjęcie o szerokości 1800 pikseli umieszczone w x=0, y=0 sięga daleko poza stronę o szerokości 612 punktów, co pokazuje, że rozmiar umieszczenia wynika z pikseli; najpierw zmniejsz zdjęcie do około 150 pikseli szerokości
Prywatność tego narzędzia
Pliki są przesyłane przez HTTPS, przetwarzane w pamięci lub w krótkotrwałym katalogu tymczasowym na naszych serwerach i usuwane, gdy wynik jest gotowy. Nie przechowujemy kopii do późniejszego przeglądania, trenowania ani profili reklamowych. Szczegóły retencji i pliki cookie AdSense znajdują się w polityce prywatności.
Najczęstsze pytania
- Dlaczego logo jest ogromne?
- Macierz cm traktuje szerokość i wysokość obrazu w pikselach jako jednostki PDF. PNG 2000 px ma 2000 punktów szerokości.
- Czy y liczy się od góry?
- Nie. W typowej przestrzeni strony PDF początek jest w lewym dolnym rogu.
- Czy mogę ustawić przezroczystość?
- Nie. Nakładka to nieprzezroczyste operatory rysowania.
- Czy SVG zachowuje wektory?
- SVG jest drukowane przez WeasyPrint do jednostronicowego PDF, a potem umieszczane jako form. Spodziewaj się wydruku, nie edytowalnego SVG.
- Jak zmniejszyć obraz?
- Zmień jego rozmiar przed przesłaniem. Nie ma pola skali, a umieszczony rozmiar wynika z wymiarów obrazu w pikselach, więc logo 150 na 50 pikseli zajmuje 150 na 50 punktów.
- Dlaczego mój przezroczysty PNG pokazuje czarne lub jednolite pole?
- Obrazy są konwertowane do RGB, a kanał alfa jest odrzucany. Wyeksportuj logo ponownie na białym tle albo umieść je w białej części strony.
- Czy mogę umieścić obraz tylko na stronie 3?
- Nie bezpośrednio. Do wyboru jest strona 1 lub każda strona. Wydziel potrzebną stronę, dodaj tam obraz, a potem połącz pliki z powrotem w kolejności.
- Czy mogę tego użyć do ukrycia tekstu na stronie?
- Nie bezpiecznie. Tekst zostaje w pliku pod obrazem i nadal można go zaznaczyć lub wyodrębnić. Gdy treść musi zostać usunięta, użyj Zaciemnij tekst.
- Obraz wychodzi poza stronę. Jak znaleźć właściwe współrzędne?
- Mierz od lewego dolnego rogu w punktach. Na stronie Letter to 612 na 792, więc x=450 i y=40 umieszcza lewy dolny róg logo blisko prawego dołu, o ile logo mieści się w pozostałych 162 punktach szerokości.
Ostatnia aktualizacja:
Wywołanie z kodu
Każde narzędzie na stronie to zwykły interfejs REST. Anonimowo nie trzeba konta ani klucza API. Działa w przeglądarce, u programistów i u agentów AI.
curl -X POST "https://pdf123.xyz/api/v1/misc/add-image" \
-F "[email protected]" \
-F "[email protected]" \
-F "x=0" \
-F "y=0" \
-F "everyPage=false" \
-o output.pdfDostępne też jako narzędzie MCP dla klientów mówiących Model Context Protocol (JSON-RPC 2.0, POST /mcp). Pełna dokumentacja API
Użyj go z agentem AI
SkillZ tym skillem Claude Code, Codex, Cursor i inne agenty AI mogą wykonać za Ciebie „Dodaj obraz”: /skills/pdf123-add-image.md
Pliki służą tylko do tego zadania i są potem automatycznie usuwane.