Lábléc PDF-ben

A képek és szövegek hozzáadása a PDF lábléc részhez különféle forgatókönyvek esetén hasznos lehet, például ha márkajelzést vagy jogi információkat ad hozzá a dokumentumokhoz. Sok iparágban elterjedt követelmény, hogy a dokumentum minden oldalának alján céglogót vagy felelősséget kizáró nyilatkozatot helyezzenek el. Más esetekben előfordulhat, hogy oldalszámokat vagy egyéb metaadatokat kell hozzáadni a dokumentum rendezéséhez vagy azonosításához. A konkrét felhasználási esettől függetlenül a képek és szövegek hozzáadása a PDF-dokumentumok láblécéhez számos vállalkozás és szervezet számára fontos funkció. Ebben a cikkben megvizsgáljuk, hogyan lehet képeket és szöveget hozzáadni egy PDF-dokumentum láblécéhez a Python Cloud SDK használatával.

A lábléchez használt másik kifejezés a “futó láb”. Ezt nagymértékben használják a kiadói ágazatban, és azért hívják így, mert tartalmazza a cikk rövidített változatát vagy egyéb információkat.

Python Cloud SDK

Az Aspose.PDF Cloud SDK for Python hatékony funkciókat kínál a PDF-dokumentumok kezeléséhez, beleértve a kép és szöveg hozzáadását a PDF-dokumentumok láblécéhez. Ez az SDK egyszerű és intuitív kezelőfelületet kínál, amely megkönnyíti a különféle PDF-ekkel kapcsolatos feladatok programozott végrehajtását. Ezzel az SDK-val gyorsan és egyszerűen hozzáadhat egyéni szöveget vagy képeket bármely PDF-dokumentum láblécéhez, professzionális és személyre szabott megjelenést biztosítva a dokumentumoknak.

Az SDK letölthető PIP és GitHub tárhelyen keresztül. Azonban egyszerűen végrehajthatja a következő parancsot a terminálban/parancssorban, hogy telepítse az SDK legújabb verzióját a rendszerre.

pip install asposepdfcloud

A következő fontos lépés az ügyfél hitelesítő adatainak beszerzése a Cloud dashboard webhelyről. Ha rendelkezik GitHub- vagy Google-fiókkal, egyszerűen regisztráljon, vagy kattintson az Új fiók létrehozása gombra, és adja meg a szükséges információkat.

Ügyfél hitelesítő adatai

  1. kép: - Ügyfél hitelesítő adatai az Aspose.Cloud irányítópulton.

Kérjük, kövesse az alábbi lépéseket, ha Python kódrészletet használ, szöveges láblécet szeretne hozzáadni a PDF-dokumentumhoz.

  • Az első lépés az ApiClient osztály egy példányának létrehozása, amelyhez argumentumként a Client ID Client Secret szükséges.
  • Másodszor, hozzon létre egy példányt a PdfApi osztályból, amelyhez ApiClient objektum szükséges bemeneti argumentumként.
  • Harmadszor, hozzon létre egy objektumot a TextFooterben, ahol a vízszintes igazítást középre, az átlátszatlanságot 0,7-re, az elforgatási szöget 356-ra és az alsó margót 5-re adtuk meg.
  • A TextFooter szövegformázásának beállításához hozzon létre egy TextState objektumot, ahol meghatározzuk az előtér színét, a betűméretet, a betűtípus nevét stb.
  • Most két opcionális paraméter értékét kell beállítanunk, amelyek meghatározzák a PDF-dokumentum kezdő- és végoldalát a szövegláb elhelyezéséhez.
  • Végül hívja meg a postdocumenttextfooter(..) metódust a szöveglábléc hozzáadásához a PDF-dokumentumhoz, és az eredményül kapott fájlt a felhőtárhelyre mentheti.
def addTextFooter():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # hozzon létre PdfApi példányt, miközben a PdfApiClient argumentumként adja át
        pdf_api = PdfApi(pdf_api_client)

        # bemeneti PDF fájl
        input_file = 'marketing.pdf'

        # Hozzon létre TextFooter példányt
        textFooter = asposepdfcloud.TextFooter()
        textFooter.background = True
        # Állítsa be a lábléc vízszintes igazítását középpontként
        textFooter.horizontal_alignment = 'Center'
        # állítsa be a lábléc átlátszatlanságát 0,7-re
        textFooter.opacity = 0.7
        textFooter.rotate = None
        # állítsa be az elforgatási szöget 5 fokra
        textFooter.rotate_angle = 5
        textFooter.x_indent = 100
        textFooter.y_indent = 100
        textFooter.zoom = .8
        # A lábléc részben megjelenítendő szöveges érték
        textFooter.value = 'Aspose.PDF Cloud SDK for Python'

        # a szöveg formázását meghatározó TextState példány létrehozása
        textState = asposepdfcloud.TextState(font_size=15, font='Arial', foreground_color=
              {"A": 0,
              "R": 66,
              "G": 111,
              "B": 245},
              background_color= {
              "A": 10,
              "R": 179,
              "G": 245,
              "B": 66},
              font_style=1)
        # rendelje hozzá a TextState objektumot a TextFooterhez
        textFooter.text_state = textState
        
        # PDF for Footer kezdőlapja
        startPage = 2
        # PDF végoldala lábléchez
        endPage = 3

        # hívja meg az API-t, hogy szöveges láblécet adjon hozzá a PDF-fájlhoz a 2. és 3. oldalon
        response = pdf_api.post_document_text_footer(name = input_file, text_footer= textFooter, start_page_number = startPage, end_page_number=endPage)
        
        # válaszkód kinyomtatása a konzolon
        print(response)
        
        # üzenet nyomtatása a konzolon (opcionális)
        print('Text Footer successfully added to PDF !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)
Szöveg lábléc előnézete

  1. kép: – A PDF-hez hozzáadott TextFooter előnézete.

Kérjük, látogasson el a következő linkre a bemeneti marketing.pdf és a kapott marketing-TextFooter.pdf letöltéséhez.

Az API azt is lehetővé teszi, hogy egy képláblécet adjon hozzá egy PDF-fájlhoz. Kérjük, kövesse az alábbi utasításokat ennek a követelménynek a teljesítéséhez.

  • Az első lépés az ApiClient osztály egy példányának létrehozása, amelyhez argumentumként a Client ID Client Secret szükséges.
  • Másodszor, hozzon létre egy példányt a PdfApi osztályból, amelyhez ApiClient objektum szükséges bemeneti argumentumként.
  • Harmadszor, hozzon létre egy objektumot az ImageFooterben, ahol a vízszintes igazítást középre, az átlátszatlanságot 0,7-re, az elforgatási szöget 10-re állítottuk be, a képfájl nevét, a margó részleteit és egyéb tulajdonságokat adtuk meg.
  • Mivel csak a láblécet kell hozzáadnunk a dokumentum első oldalához, ezért a startpagenumber és endpagenumber opcionális paramétereket beállítottuk.
  • Végül hívja meg a postdocumentimagefooter(..) metódust, hogy szöveges láblécet adjon a PDF-dokumentumhoz, és mentse a kapott fájlt a felhőtárhelyre.
def addImageFooter():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # hozzon létre PdfApi példányt, miközben a PdfApiClient argumentumként adja át
        pdf_api = PdfApi(pdf_api_client)

        # PDF dokumentum bevitele
        input_file = 'marketing.pdf'
        
        # Hozzon létre ImageFooter példányt
        imageFooter = asposepdfcloud.ImageFooter()
        
        # fejléc megjelenítése a PDF-tartalom tetején
        imageFooter.background = False
        # állítsa be az igazítást balra
        imageFooter.horizontal_alignment = 'Left'
        # állítsa be az átlátszatlanságot 70%-ra
        imageFooter.opacity = 0.7
        imageFooter.rotate = None
        imageFooter.rotate_angle = 10
        imageFooter.x_indent = 10
        imageFooter.y_indent = 10
        imageFooter.zoom = .7
        
        # bemeneti képfájl
        imageFooter.file_name = 'Koala.jpg'
        # állítsa be a kép szélességének és magasságának részleteit
        imageFooter.width = 100
        imageFooter.height = 100
        # adja meg a margó részleteit a láblécképhez
        imageFooter.bottom_margin = 2
        imageFooter.left_margin = 1
        imageFooter.right_margin = 10

        # a dokumentum kezdőlapja lábléc hozzáadásához
        startPage = 1
        # a dokumentum kezdőlapja lábléc hozzáadásához
        endPage = 1

        # hívja meg az API-t a kép láblécének PDF-fájlban való megjelenítéséhez
        response = pdf_api.post_document_image_footer(name = input_file, image_footer= imageFooter, start_page_number = startPage, end_page_number=endPage)
        
        # válaszkód kinyomtatása a konzolban
        print(response)
        
        # üzenet nyomtatása a konzolon (opcionális)
        print('Image Footer successfully added to PDF !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)
Képlábléc PDF-ben

  1. kép: - Az Image Footer előnézete PDF-ben.

A fenti példával előállított fájl letölthető a marketing-ImageFooter.pdf webhelyről.

A cURL parancsok és az Aspose.PDF Cloud használata szöveg és kép hozzáadásához a PDF láblécében számos előnnyel jár. Először is kiküszöböli a PDF-dokumentumok kézi szerkesztésének szükségességét, amely időigényes és hibás lehet. Másodszor, lehetővé teszi a fejléc szövegének egyszerű testreszabását, a szöveg betűtípusának, méretének, színének és helyzetének megváltoztatásával. Harmadszor, lehetővé teszi a felhasználók számára, hogy egyszerre több PDF-dokumentumhoz is hozzáadjanak szöveget, ezzel időt takaríthatnak meg és növelhetik a hatékonyságot. Végül ez a megközelítés biztonságos és megbízható módszert biztosít a PDF fejléchez való szöveg hozzáadására, ahol az összes adatot biztonságos kapcsolaton keresztül továbbítják, és biztonságos szervereken dolgozzák fel.

Most előfeltételként hozzon létre egy JSON Web Tokent (JWT) a következő parancs végrehajtásával.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=88d1cda8-b12c-4a80-b1ad-c85ac483c5c5&client_secret=406b404b2df649611e508bbcfcd2a77f" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Most, hogy létrehoztuk a JWT tokent, a következő parancsot kell végrehajtanunk a TextFooter PDF-fájlhoz való hozzáadásához.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/marketing.pdf/footer/text?startPageNumber=2&endPageNumber=3" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Background\": true,  \"HorizontalAlignment\": \"Center\",  \"Opacity\": 0.7,  \"Rotate\": \"None\",  \"RotateAngle\": 5,  \"XIndent\": 100,  \"YIndent\": 100,  \"Zoom\": 0.8,  \"Value\": \"Aspose.PDF Cloud SDK for Python\",  \"TextState\": {    \"FontSize\": 15,    \"Font\": \"Arial\",    \"ForegroundColor\": {      \"A\": 0,      \"R\": 66,      \"G\": 111,      \"B\": 245    },    \"BackgroundColor\": {      \"A\": 10,      \"R\": 179,      \"G\": 245,      \"B\": 66    },    \"FontStyle\": \"Regular\"  },  \"BottomMargin\": 3,  \"LeftMargin\": 3,  \"RightMargin\": 3}"

Kérjük, hajtsa végre a következő parancsot a képfejléc hozzáadásához a PDF-fájlhoz a cURL paranccsal.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/marketing.pdf/footer/image?startPageNumber=1&endPageNumber=1" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Background\": false,  \"HorizontalAlignment\": \"Left\",  \"Opacity\": 0.7,  \"Rotate\": \"None\",  \"RotateAngle\": 10,  \"XIndent\": 10,  \"YIndent\": 10,  \"Zoom\": 0.7,  \"FileName\": \"Koala.jpg\",  \"Width\": 100,  \"Height\": 100,  \"BottomMargin\": 2,  \"LeftMargin\": 1,  \"RightMargin\": 10}"

Következtetés

Összefoglalva, a kép és a szöveg hozzáadása a PDF-dokumentum lábléc részéhez hasznos funkció lehet különféle célokra, beleértve a márkaépítést, a jogi megfelelést és a dokumentumszervezést. Az Aspose.PDF Cloud SDK for Python kényelmes és hatékony módot biztosít ennek a funkciónak a Python-alkalmazásban való megvalósítására. Másrészt a cURL parancsok használata az Aspose.PDF Cloud API-val rugalmasságot és egyszerűséget kínálhat a funkció különféle programozási nyelvekbe és környezetekbe történő integrálásához. A választott megközelítéstől függetlenül az Aspose.PDF Cloud robusztus és megbízható eszközöket kínál a PDF-dokumentumok lábléc részéhez kép és szöveg hozzáadásához.

Hasznos linkek

Kapcsolódó cikkek

Javasoljuk, hogy olvassa el a következő cikkeket, hogy többet megtudjon: