Panduan ini menjelaskan cara menentukan ukuran dan posisi elemen halaman menggunakan transformasi affine. Untuk pengantar konseptual tentang transformasi affine, lihat panduan konsep Transformasi.
Mentransformasi elemen
Slides API memungkinkan Anda mengubah posisi dan menskalakan elemen pada halaman. Untuk melakukannya, tentukan jenis transformasi yang akan diterapkan terlebih dahulu, lalu terapkan transformasi tersebut menggunakan metode presentations.batchUpdate yang berisi satu atau beberapa elemen UpdatePageElementTransformRequest.
Transformasi dapat dibuat dalam salah satu dari dua applyModes:
Transformasi
ABSOLUTE
menggantikan matriks transformasi elemen yang ada. Setiap parameter yang Anda hapus dari permintaan update transformasi akan ditetapkan ke nol.Transformasi
RELATIVE
dikalikan dengan matriks transformasi elemen yang sudah ada (urutan perkalian penting):
Transformasi relatif memindahkan atau menskalakan elemen halaman dari lokasi saat ini; misalnya, memindahkan bentuk 100 titik ke kiri, atau memutarnya 40 derajat. Transformasi absolut menghapus informasi posisi dan skala yang ada; misalnya, memindahkan bentuk ke tengah halaman, atau menskalakannya ke lebar tertentu.
Transformasi kompleks biasanya dapat dinyatakan sebagai urutan transformasi yang lebih sederhana. Menghitung transformasi di awal—menggabungkan beberapa transformasi menggunakan perkalian matriks—sering kali dapat mengurangi overhead.
Untuk beberapa operasi, Anda harus mengetahui apa saja parameter transformasi elemen yang ada. Jika tidak memiliki nilai ini, Anda dapat mengambilnya dengan permintaan presentations.pages.get.
Terjemahan
Terjemahan hanyalah tindakan memindahkan elemen halaman ke posisi baru di halaman yang sama. Terjemahan absolut memindahkan elemen ke titik tertentu, sedangkan terjemahan relatif memindahkan elemen dengan jarak tertentu.
Matriks transformasi penerjemahan dasar memiliki bentuk:
Saat menggunakan UpdatePageElementTransformRequest untuk menerjemahkan elemen (tanpa mengubah ukuran, pemotongan, atau orientasinya), Anda dapat menggunakan salah satu struktur AffineTransform berikut:
// Absolute translation: { 'transform': { 'scaleX': current scaleX value, 'scaleY': current scaleY value, 'shearX': current shearX value, 'shearY': current shearY value, 'translateX': X coordinate to move to, 'translateY': Y coordinate to move to, 'unit': 'EMU' // or 'PT' } } // Relative translation (scaling must also be provided to avoid a matrix multiplication error): { 'transform': { 'scaleX': 1, 'scaleY': 1, 'translateX': X coordinate to move by, 'translateY': Y coordinate to move by, 'unit': 'EMU' // or 'PT' } }
Penskalaan
Penskalaan adalah tindakan merentangkan atau menekan elemen di sepanjang dimensi X dan/atau Y untuk mengubah ukurannya. Matriks transformasi penskalaan dasar memiliki bentuk:
Anda dapat menggunakan bentuk matriks ini secara langsung sebagai transformasi RELATIVE
untuk mengubah ukuran elemen, tetapi hal ini juga dapat memengaruhi pemotongan dan terjemahan elemen yang dirender.
Untuk menskalakan elemen tanpa memengaruhi pemotongan atau penerjemahannya, pindahkan ke
frame referensinya.
Rotasi
Transformasi rotasi memutar elemen halaman di sekitar titik, menggunakan parameter penskalaan dan geser. Matriks transformasi rotasi dasar memiliki bentuk berikut, dengan sudut rotasi (dalam radian) diukur dari sumbu X, yang bergerak berlawanan arah jarum jam:
Seperti halnya penskalaan, Anda dapat menggunakan bentuk matriks ini secara langsung sebagai transformasi RELATIVE
untuk memutar elemen, tetapi hal ini menyebabkan elemen diputar di sekitar asal halaman. Untuk memutar elemen di sekitar pusatnya atau
titik yang berbeda,
geser ke frame referensi tersebut.
Refleksi
Refleksi mencerminkan sebuah elemen pada garis atau sumbu tertentu. Matriks transformasi refleksi sumbu x dan y dasar memiliki bentuk berikut:
Seperti penskalaan, Anda dapat menggunakan bentuk matriks ini secara langsung sebagai transformasi RELATIVE
untuk mencerminkan elemen, tetapi ini juga menyebabkan elemen diterjemahkan. Untuk merefleksikan elemen tanpa terjemahan apa pun,
pindahkan ke frame referensinya.
Frame referensi elemen
Menerapkan transformasi skala, refleksi, atau rotasi dasar secara langsung ke elemen halaman akan menghasilkan transformasi dalam frame referensi halaman. Misalnya, rotasi dasar memutar elemen di seputar asal halaman (sudut kiri atas). Namun, Anda dapat beroperasi dalam frame referensi elemen itu sendiri, misalnya untuk memutar elemen di sekitar titik tengahnya.
Untuk mengubah elemen dalam bingkai referensinya sendiri, tempatkan elemen di antara dua
terjemahan lainnya: T1
terjemahan sebelumnya yang memindahkan pusat elemen
ke asal halaman, dan T2
terjemahan berikutnya yang memindahkan elemen
kembali ke posisi aslinya. Operasi penuh dapat dinyatakan sebagai produk matriks:
Anda juga dapat beralih ke frame referensi lain, dengan menerjemahkan titik yang berbeda ke asalnya. Titik-titik ini menjadi pusat frame referensi baru.
Anda dapat melakukan setiap transformasi ini satu per satu sebagai
permintaan transformasi RELATIVE
berurutan. Idealnya, Anda harus menghitung A'
di atas dengan perkalian matriks dan menerapkan hasilnya sebagai transformasi ABSOLUTE
tunggal. Atau, hitung hasil perkalian T2 * B * T1
terlebih dahulu
dan terapkan sebagai transformasi RELATIVE
tunggal. Keduanya lebih efisien, dalam hal operasi API, daripada mengirim permintaan transformasi satu per satu.
Batasan
Beberapa kolom ukuran dan posisi tidak kompatibel dengan beberapa jenis elemen halaman. Tabel di bawah merangkum kompatibilitas elemen halaman tertentu dengan kolom ukuran dan pemosisian.
Kolom | Bentuk | Video | Tabel |
---|---|---|---|
Terjemahan | ✔ | ✔ | ✔ |
Skala | ✔ | ✔ | Tidak** |
Geser | ✔ | Tidak | Tidak |
** Untuk memperbarui dimensi baris dan kolom tabel, gunakan
UpdateTableRowPropertiesRequest
dan
UpdateTableColumnPropertiesRequest
.
Semua kolom ukuran dan posisi mungkin memberikan hasil yang tidak diharapkan jika elemen halaman memiliki geseran. Semua batasan dapat berubah sewaktu-waktu. Untuk mengetahui informasi terbaru, lihat Google Slides API.
Slides API dapat memfaktorkan ulang nilai Anda
Saat membuat elemen halaman, Anda dapat menentukan ukuran dan transformasi yang memberikan hasil visual tertentu. Namun, API dapat mengganti nilai yang Anda berikan dengan nilai lain yang menghasilkan tampilan visual yang sama. Secara umum, jika Anda menulis ukuran menggunakan API, tidak ada jaminan bahwa Anda akan mendapatkan ukuran yang sama. Namun, Anda akan mendapatkan hasil yang sama jika mempertimbangkan transformasi.