การดําเนินการเปลี่ยนรูปแบบ

Google Slides API ช่วยให้คุณจัดการตำแหน่ง ขนาด และการวางแนวของ PageElement (กล่องข้อความ รูปภาพ ตาราง และรูปร่างพื้นฐาน) ในหน้าได้ โดยจะรักษาสายให้ ตรงและคงจุดและเส้นขนานไว้ ซึ่งเรียกว่า การแปลงแบบแอฟฟิน ตัวอย่างในที่นี้แสดงการดำเนินการแปลงองค์ประกอบของหน้าบางอย่างที่พบบ่อยโดยใช้วิธี presentations.batchUpdate

ตัวอย่างเหล่านี้ใช้ตัวแปรต่อไปนี้

• PRESENTATION_ID - ระบุตำแหน่งที่คุณระบุ รหัสงานนำเสนอ คุณดูค่าของรหัสนี้ได้จาก URL ของงานนำเสนอ
• PAGE_ID - ระบุตำแหน่งที่คุณระบุรหัส ออบเจ็กต์ของหน้า คุณดึงค่านี้ได้จาก URL หรือโดยใช้คำขออ่าน API
• PAGE_ELEMENT_ID - ระบุตำแหน่งที่คุณระบุรหัสออบเจ็กต์ขององค์ประกอบหน้า คุณระบุรหัสนี้สำหรับองค์ประกอบที่คุณสร้างขึ้นได้ (โดยมีข้อจำกัดบางอย่าง) หรืออนุญาตให้ Slides API สร้างรหัสโดยอัตโนมัติ คุณดึงข้อมูลรหัสองค์ประกอบได้ผ่านคำขออ่าน API

ตัวอย่างเหล่านี้แสดงเป็นคำขอ HTTP เพื่อให้เป็นกลางทางภาษา ดูวิธีใช้งานการอัปเดตเป็นกลุ่มในภาษาต่างๆ โดยใช้ไลบรารีไคลเอ็นต์ Google API ได้ที่ เพิ่มรูปร่างและ ข้อความ

ตัวอย่างรูปร่างลูกศร

สำหรับตัวอย่างด้านล่างนี้ ให้ถือว่ามีองค์ประกอบหน้าของรูปร่างลูกศรตัวอย่างที่มีขนาดและข้อมูลการแปลงต่อไปนี้ (ซึ่งดูได้ด้วยคำขอเมธอด presentations.pages.get ) รูปร่างตัวอย่างใช้หน่วยวัด unit EMU (English Metric Unit) และ pt (point)

{
  "objectId": PAGE_ELEMENT_ID,
  "size": {
    "width": {
      "magnitude": 3000000,
      "unit": "EMU"
    },
    "height": {
      "magnitude": 3000000,
      "unit": "EMU"
    }
  },
  "transform": {
    "scaleX": 0.3,
    "scaleY": 0.12,
    "shearX": 0,
    "shearY": 0,
    "translateX": 2000000,
    "translateY":  550000,
    "unit": "EMU"
  },
  "shape": {
    "shapeType": "RIGHT_ARROW"
  }
}

จัดองค์ประกอบให้ตรงกับองค์ประกอบอื่น

ตัวอย่างโค้ดต่อไปนี้ presentations.batchUpdate แสดงวิธีใช้เมธอด CreateShapeRequest เพื่อสร้างรูปร่างใหม่ในตำแหน่งที่ถูกต้องซึ่งจัดให้ตรงกับ รูปร่างลูกศรตัวอย่างในหน้า ในทั้ง 2 กรณี คุณต้องคำนวณพิกัด X และ Y ของมุมบนซ้ายของรูปร่างใหม่

คำขอแรกจะสร้างสี่เหลี่ยมผืนผ้าขนาด 100 x 50 pt ซึ่งจัดให้ตรงกับเส้นขอบด้านซ้ายของรูปร่างลูกศร แต่วางตำแหน่งไว้ 50 pt (50 * 12,700 = 635,000 EMU) ใต้ขอบบนของลูกศร พิกัด X ของสี่เหลี่ยมผืนผ้าใหม่ควรเหมือนกับพิกัด X ของลูกศรเพื่อให้เส้นขอบด้านซ้ายจัดแนวตรงกัน พิกัด Y จะเหมือนกับพิกัด Y ของลูกศรบวก 50 pt เนื่องจากระยะทางวัดจากด้านบนของลูกศร ดังนั้นพิกัดของสี่เหลี่ยมผืนผ้าจึงเป็นดังนี้

x" = 2000000 EMU
y" = 550000 + (50 * 12700) = 1185000 EMU

คำขอที่ 2 จะสร้างวงกลมกว้าง 40 pt ซึ่งมีเส้นกึ่งกลางแนวนอนเหมือนกับลูกศรตัวอย่าง แต่วางตำแหน่งไว้ 100 pt (1,270,000 EMU) ทางด้านขวาของขอบด้านขวาของลูกศร พิกัด X ของวงกลมคือผลรวมของพิกัด X ของลูกศร ความกว้างของลูกศร และ 100 pt การบังคับให้จัดแนวเส้นกึ่งกลางสำหรับวงกลมใหม่ต้องคำนึงถึงความสูงของทั้งลูกศรและวงกลม พิกัด Y ของวงกลมคือพิกัด Y ของลูกศรบวกความสูงครึ่งหนึ่งของลูกศรลบความสูงครึ่งหนึ่งของวงกลม ในทั้ง 2 กรณี คุณต้องคำนึงถึงปัจจัยการปรับขนาดที่เชื่อมโยงกับลูกศรด้วย เนื่องจากปัจจัยเหล่านี้ส่งผลต่อความกว้างและความสูงที่แสดงผลของลูกศร ดังนั้นพิกัดของวงกลมจึงเป็นดังนี้

x = 2000000 + (0.3 * 3000000) + (100 * 12700) = 4170000 EMU
y = 550000 + (0.5 * 0.12 * 3000000) - (0.5 * 40 * 12700) = 476000 EMU

ต่อไปนี้เป็นโปรโตคอลคำขอเพื่อจัดองค์ประกอบให้ตรงกับองค์ประกอบอื่น

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createShape": {
        "shapeType": "RECTANGLE",
        "elementProperties": {
          "pageObjectId": PAGE_ID,
          "size": {
            "width": {
              "magnitude": 100,
              "unit": "PT"
            },
            "height": {
              "magnitude": 50,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 2000000,
            "translateY": 1185000,
            "unit": "EMU"
          }
        }
      }
    },
    {
      "createShape": {
        "shapeType": "ELLIPSE",
        "elementProperties": {
          "pageObjectId": PAGE_ID,
          "size": {
            "width": {
              "magnitude": 40,
              "unit": "PT"
            },
            "height": {
              "magnitude": 40,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 4170000,
            "translateY":  476000,
            "unit": "EMU"
          }
        }
      }
    }
  ]
}

ย้ายองค์ประกอบ

ตัวอย่างโค้ด presentations.batchUpdate ต่อไปนี้แสดงวิธีใช้เมธอด UpdatePageElementTransformRequest เพื่อแปลองค์ประกอบของหน้ารูปร่างลูกศรตัวอย่างใน 2 วิธีที่แตกต่างกัน

คำขอแรกในชุดจะย้ายลูกศรไปยังพิกัด (X,Y) = (2000000, 150000) EMU (โดยใช้ การแปลแบบสัมบูรณ์ applyMode) คำขอที่ 2 ในชุดจะย้ายลูกศรจากตำแหน่งนั้น โดยคราวนี้ย้ายไปทางขวา 40,000 EMU และขึ้นไป 35,000 EMU (โดยใช้ การแปลแบบสัมพัทธ์ applyMode) เมทริกซ์การแปลง1 ที่ใช้ สร้างขึ้นเพื่อหลีกเลี่ยงการเปลี่ยนแปลงขนาดและการวางแนวขององค์ประกอบ

หลังจากดำเนินการคำขอทั้ง 2 รายการแล้ว มุมบนซ้ายของลูกศรจะอยู่ที่พิกัด (X,Y) = (2040000, 115000) EMU

ต่อไปนี้เป็นโปรโตคอลคำขอเพื่อย้ายองค์ประกอบ

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "updatePageElementTransform": {
        "objectId": PAGE_ELEMENT_ID,
        "applyMode": "ABSOLUTE",
        "transform": {
            "scaleX": 0.3,
            "scaleY": 0.12,
            "translateX": 2000000,
            "translateY":  150000,
            "unit": "EMU"
        }
      }
    },
    {
      "updatePageElementTransform": {
        "objectId": PAGE_ELEMENT_ID,
        "applyMode": "RELATIVE",
        "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX":  40000,
            "translateY": -35000,
            "unit": "EMU"
        }
      }
    }
  ]
}

สะท้อนองค์ประกอบ

ตัวอย่างโค้ดต่อไปนี้ presentations.batchUpdate แสดงวิธีใช้เมธอด UpdatePageElementTransformRequest เพื่อสะท้อนองค์ประกอบของหน้าของรูปร่างลูกศรตัวอย่าง ในแนวนอนตามกึ่งกลาง โดยไม่เปลี่ยนแปลงตำแหน่งในหน้าหรือ การปรับขนาด

ซึ่งทำได้โดยใช้การแปลงการสะท้อนพื้นฐานในเฟรมอ้างอิง ขององค์ประกอบ เพื่อความชัดเจน การเลื่อนเฟรมอ้างอิงและการสะท้อนจะแสดงด้วยการเรียกเมธอด UpdatePageElementTransformRequest 3 ครั้งแยกกัน แต่การคำนวณล่วงหน้าของผลคูณของเมทริกซ์การแปลงเหล่านี้แล้วใช้ผลคูณนั้นเป็นคำขอเดียวจะมีประสิทธิภาพมากกว่า

สำหรับการแปลงการแปล ระบบจะย้าย กึ่งกลางของรูปร่างลูกศรไปยังและออกจากจุดเริ่มต้น ค่าพารามิเตอร์จะแสดงเป็นการคำนวณเพื่อความชัดเจน

ต่อไปนี้เป็นโปรโตคอลคำขอเพื่อสะท้อนองค์ประกอบ

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "updatePageElementTransform": {
        "objectId": PAGE_ELEMENT_ID,
        "applyMode": "RELATIVE",
        "transform": {
            "scaleX":  1,
            "scaleY":  1,
            "translateX": -2000000 - 0.5 * 0.3  * 3000000,
            "translateY":  -550000 - 0.5 * 0.12 * 3000000,
            "unit": "EMU"
        }
      }
    },
    {
      "updatePageElementTransform": {
        "objectId": PAGE_ELEMENT_ID,
        "applyMode": "RELATIVE",
        "transform": {
            "scaleX": -1,
            "scaleY":  1,
            "unit": "EMU"
        }
      }
    },
    {
      "updatePageElementTransform": {
        "objectId": PAGE_ELEMENT_ID,
        "applyMode": "RELATIVE",
        "transform": {
            "scaleX":  1,
            "scaleY":  1,
            "translateX":  2000000 + 0.5 * 0.3  * 3000000,
            "translateY":   550000 + 0.5 * 0.12 * 3000000,
            "unit": "EMU"
        }
      }
    }
  ]
}

ปรับขนาดองค์ประกอบ

ตัวอย่างโค้ด presentations.batchUpdate ต่อไปนี้แสดงวิธีใช้เมธอด UpdatePageElementTransformRequest เพื่อปรับขนาดองค์ประกอบหน้าของรูปร่างลูกศรตัวอย่างให้กว้างขึ้น 50% และมีความสูงเพียง 80% ของความสูงปัจจุบัน โดยจะรักษากึ่งกลางของลูกศร ไว้ในตำแหน่งเดิมและคงการวางแนวไว้

ซึ่งทำได้โดยใช้การแปลงการปรับขนาดพื้นฐานในเฟรมอ้างอิง ขององค์ประกอบ เพื่อความชัดเจน การเลื่อนเฟรมอ้างอิงและการปรับขนาดจะแสดงด้วยการเรียกเมธอด UpdatePageElementTransformRequest 3 ครั้งแยกกัน แต่การคำนวณล่วงหน้าของผลคูณของเมทริกซ์การแปลงเหล่านี้แล้วใช้ผลคูณนั้นเป็นคำขอเดียวจะมีประสิทธิภาพมากกว่า

สำหรับการแปลงการแปล ระบบจะย้าย กึ่งกลางของรูปร่างลูกศรไปยังและออกจากจุดเริ่มต้น ค่าพารามิเตอร์จะแสดงเป็นการคำนวณเพื่อความชัดเจน

ต่อไปนี้เป็นโปรโตคอลคำขอเพื่อปรับขนาดองค์ประกอบ

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "updatePageElementTransform": {
          "objectId": PAGE_ELEMENT_ID,
          "applyMode": "RELATIVE",
          "transform": {
              "scaleX":  1,
              "scaleY":  1,
              "translateX": -2000000 - 0.5 * 0.3  * 3000000,
              "translateY":  -550000 - 0.5 * 0.12 * 3000000,
              "unit": "EMU"
          }
      }
    },
    {
      "updatePageElementTransform": {
        "objectId": PAGE_ELEMENT_ID,
        "applyMode": "RELATIVE",
        "transform": {
            "scaleX": 1.5,
            "scaleY": 0.8,
            "unit": "EMU"
        }
      }
    },
    {
      "updatePageElementTransform": {
        "objectId": PAGE_ELEMENT_ID,
        "applyMode": "RELATIVE",
        "transform": {
            "scaleX":  1,
            "scaleY":  1,
            "translateX":  2000000 + 0.5 * 0.3  * 3000000,
            "translateY":   550000 + 0.5 * 0.12 * 3000000,
            "unit": "EMU"
        }
      }
    }
  ]
}

หมุนองค์ประกอบรอบกึ่งกลาง

ตัวอย่างโค้ดต่อไปนี้ presentations.batchUpdate แสดงวิธีใช้เมธอด UpdatePageElementTransformRequest เพื่อหมุนองค์ประกอบของหน้าของรูปร่างลูกศรตัวอย่าง 35 องศาทวนเข็มนาฬิกา โดยจะรักษากึ่งกลางของลูกศรไว้ในตำแหน่งเดิม และคงขนาดไว้

ซึ่งทำได้โดยใช้การแปลงการหมุนพื้นฐาน ในเฟรมอ้างอิง ขององค์ประกอบ เพื่อความชัดเจน การเลื่อนเฟรมอ้างอิงและการหมุนจะแสดงด้วยการเรียกเมธอด UpdatePageElementTransformRequest 3 ครั้งแยกกัน แต่การคำนวณล่วงหน้าของผลคูณของเมทริกซ์การแปลงเหล่านี้แล้วใช้ผลคูณนั้นเป็นคำขอเดียวจะมีประสิทธิภาพมากกว่า

สำหรับการแปลงการแปล ระบบจะย้าย กึ่งกลางของรูปร่างลูกศรไปยังและออกจากจุดเริ่มต้น ค่าพารามิเตอร์จะแสดงเป็นการคำนวณเพื่อความชัดเจน

ต่อไปนี้เป็นโปรโตคอลคำขอเพื่อหมุนองค์ประกอบรอบกึ่งกลาง

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "updatePageElementTransform": {
          "objectId": PAGE_ELEMENT_ID,
          "applyMode": "RELATIVE",
          "transform": {
              "scaleX":  1,
              "scaleY":  1,
              "translateX": -2000000 - 0.5 * 0.3  * 3000000,
              "translateY":  -550000 - 0.5 * 0.12 * 3000000,
              "unit": "EMU"
          }
      }
    },
    {
      "updatePageElementTransform": {
        "objectId": PAGE_ELEMENT_ID,
        "applyMode": "RELATIVE",
        "transform": {
            "scaleX":  cos(35 * (pi/180)),
            "scaleY":  cos(35 * (pi/180)),
            "shearX":  sin(35 * (pi/180)),
            "shearY": -sin(35 * (pi/180)),
            "unit": "EMU"
        }
      }
    },
    {
      "updatePageElementTransform": {
        "objectId": PAGE_ELEMENT_ID,
        "applyMode": "RELATIVE",
        "transform": {
            "scaleX":  1,
            "scaleY":  1,
            "translateX":  2000000 + 0.5 * 0.3  * 3000000,
            "translateY":   550000 + 0.5 * 0.12 * 3000000,
            "unit": "EMU"
        }
      }
    }
  ]
}