จัดรูปแบบรูปร่าง PowerPoint ใน Python ผ่าน Java
บทนำ
จัดรูปแบบรูปร่างใน PowerPoint โดยปรับเส้นขอบ การเติมสีและเอฟเฟกต์ต่าง ๆ Aspose.Slides สำหรับ Python ผ่าน Java ทำให้คุณสามารถควบคุมการตั้งค่าเหล่านี้ด้วยโปรแกรม รวมถึงความโปร่งใส การหมุนและการจัดรูปแบบ 3 มิติ

Aspose.Slides สำหรับ Python ผ่าน Java ให้คลาสและเมธอดที่ช่วยให้คุณจัดรูปแบบรูปร่างโดยใช้ตัวเลือกเดียวกับที่มีใน PowerPoint
จัดรูปแบบเส้น
ใช้ Shape.getLineFormat เพื่อควบคุมเส้นขอบของรูปร่าง ตัวอย่างนี้สร้างสี่เหลี่ยมผืนผ้าไม่มีการเติมสีโดยมีเส้นขอบสีน้ำเงินแบบเส้นประ LineFormat.setStyle เลือกเส้นผสมหนา‑บางในขณะที่ LineFormat.setWidth ตั้งความกว้างเป็น 7 จุดและ LineFormat.setDashStyle เลือกรูปแบบเส้นประ
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineDashStyle, LineStyle, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
shape.getFillFormat().setFillType(FillType.NoFill)
shape.getLineFormat().setStyle(LineStyle.ThickThin)
shape.getLineFormat().setWidth(7)
shape.getLineFormat().setDashStyle(LineDashStyle.Dash)
shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
presentation.save("formatted_lines.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์:

ตั้งค่ารูปแบบเส้นประแบบกำหนดเอง
ใช้ LineFormat.setCustomDashPattern เมื่อรูปแบบเส้นที่กำหนดไว้ล่วงหน้าไม่ให้ความยาวและช่องว่างของเส้นประที่คุณต้องการ เช่น สำหรับเส้นขอบแบรนด์หรือแผนภูมิเทคนิค การกำหนดรูปแบบจะเปลี่ยนสไตล์เส้นประโดยอัตโนมัติเป็น LineDashStyle.Custom
รายการในอาร์เรย์สลับกันระหว่างความยาวของเส้นประและช่องว่าง เริ่มด้วยเส้นประ แต่ละค่าจะเป็นผลคูณของความกว้างของเส้น: [4, 2] ที่ความกว้าง 3 จุดจะสร้างเส้นประ 12 จุดตามด้วยช่องว่าง 6 จุด ใช้คู่ของค่าที่เป็นจำนวนเต็มบวกหรือศูนย์เพื่อกำหนดส่วนเต็มของเส้นประและช่องว่าง ตัวอย่างใช้ค่าบวกเพื่อให้เส้นประและช่องว่างทั้งหมดมองเห็นได้
ตัวอย่างนี้สร้างเส้นสีน้ำเงิน 5 เส้นที่มีความยาวและปลายเส้นแบบแบนเท่ากัน สามเส้นแรกเปรียบเทียบรูปแบบที่ความกว้าง 3 จุด เส้นที่สี่ทำซ้ำรูปแบบแรกที่สองเท่าของความกว้าง ทำให้ความยาวของเส้นประและช่องว่างเพิ่มเป็นสองเท่า เส้นที่ห้าสลับจากรูปแบบกำหนดเองเป็นเส้นทึบ
import jpype
import asposeslides
if not jpole.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineArrowheadStyle, LineCapStyle, LineDashStyle, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(600, 300, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
patterns = [
[4, 2],
[1, 2],
[6, 2, 1, 2],
[4, 2],
[4, 2]
]
for i, pattern in enumerate(patterns):
line = slide.getShapes().addAutoShape(ShapeType.Line, 50, 50 + i * 50, 500, 0)
line.getLineFormat().setWidth(6 if i == 3 else 3)
line.getLineFormat().getFillFormat().setFillType(FillType.Solid)
color = Color(0, 0, 139)
line.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
line.getLineFormat().setCapStyle(LineCapStyle.Flat)
line.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.None_)
line.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.None_)
line.getLineFormat().setCustomDashPattern(jpype.JArray(jpype.JFloat)(pattern))
# คืนเส้นสุดท้ายเป็นสไตล์เส้นทึบ.
slide.getShapes().get_Item(4).getLineFormat().setDashStyle(LineDashStyle.Solid)
presentation.save("custom_dash_patterns.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
หากต้องการกลับไปใช้สไตล์เส้นประที่กำหนดไว้ล่วงหน้า ให้ส่งค่า LineDashStyle.Dash ไปยัง LineFormat.setDashStyle สไตล์ที่เลือกจะควบคุมลักษณะของเส้น
ผลลัพธ์ใน PowerPoint จากบนลงล่าง: {4, 2}, 3 pt; {1, 2}, 3 pt; {6, 2, 1, 2}, 3 pt; {4, 2}, 6 pt; และ Solid, 3 pt

ตั้งค่าปลายเส้น
ใช้ LineFormat.setCapStyle เพื่อกำหนดปลายของเส้นเปิด คลาส LineCapStyle มีสไตล์ปลายสามแบบชัดเจน:
Flat: เส้นสีหยุดที่จุดสุดท้ายRound: ปลายครึ่งวงกลมต่อออกจากจุดสุดท้ายไปอีกครึ่งความกว้างของเส้นSquare: ปลายสี่เหลี่ยมต่อออกจากจุดสุดท้ายไปอีกครึ่งความกว้างของเส้น
คลาสนี้ยังมีค่า NotDefined ซึ่งหมายถึงไม่มีการกำหนดสไตล์ปลายอย่างชัดเจน
ปลายเส้นแตกต่างจากหัวศร ซึ่งจะเพิ่มสัญลักษณ์ที่ปลายเส้นและการเชื่อมต่อซึ่งควบคุมมุมระหว่างส่วนของเส้น ตัวอย่างนี้ปิดการใช้งานหัวศรผ่าน LineFormat.setBeginArrowheadStyle และ LineFormat.setEndArrowheadStyle เพื่อให้เปรียบเทียบเฉพาะรูปแบบปลายเส้น
ตัวอย่างต่อไปนี้สร้างเส้นแนวนอนสามเส้นที่เหมือนกันโดยมีความกว้าง 20 จุด ตั้งแต่บนลงล่างจะใช้ปลายเส้น Flat, Round, และ Square ตามลำดับ จุดสุดท้ายของเส้นมีพิกัดแนวนอนเดียวกัน; ปลายเส้นแบบ Round และ Square จะยืดออกไปอีก 10 จุดจากแต่ละจุดสุดท้าย
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineArrowheadStyle, LineCapStyle, LineDashStyle, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(500, 240, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
cap_styles = [LineCapStyle.Flat, LineCapStyle.Round, LineCapStyle.Square]
for i, cap_style in enumerate(cap_styles):
line = slide.getShapes().addAutoShape(ShapeType.Line, 100, 50 + i * 70, 300, 0)
line.getLineFormat().setWidth(20)
line.getLineFormat().getFillFormat().setFillType(FillType.Solid)
color = Color(0, 0, 139)
line.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
line.getLineFormat().setDashStyle(LineDashStyle.Solid)
line.getLineFormat().setCapStyle(cap_style)
line.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.None_)
line.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.None_)
presentation.save("line_caps.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์ใน PowerPoint จากบนลงล่าง: Flat, Round, และ Square

นำเอฟเฟกต์สเก็ตช์ไปใช้กับเส้นของรูปร่าง
เอฟเฟกต์สเก็ตช์ทำให้เส้นของรูปร่างดูเหมือนวาดด้วยมือ ใช้ Shape.getLineFormat เพื่อเข้าถึงการตั้งค่าเส้น, LineFormat.getSketchFormat เพื่อเข้าถึงการตั้งค่าสเก็ตช์, และ SketchFormat.setSketchType เพื่อเลือกค่าจากคลาส LineSketchType
โค้ด Python ด้านล่างแสดงวิธีการใช้เอฟเฟกต์ LineSketchType.Curved , อ่านค่าที่กำหนดอย่างชัดเจน, และลบเอฟเฟกต์ด้วย LineSketchType.None_:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import LineSketchType, Presentation, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 200, 100)
sketch_format = shape.getLineFormat().getSketchFormat()
sketch_format.setSketchType(LineSketchType.Curved)
explicit_sketch_type = sketch_format.getSketchType()
print("Explicit sketch type:", explicit_sketch_type)
sketch_format.setSketchType(LineSketchType.None_)
finally:
presentation.dispose()
ค่าที่คืนจาก SketchFormat.getSketchType แสดงการตั้งค่าที่กำหนดโดยตรงให้กับรูปร่าง หากการจัดรูปแบบเส้นสามารถสืบทอดจากธีม, มาสเตอร์สไลด์, หรือเลเอาต์สไลด์ ให้ใช้ LineFormat.getEffective แล้วอ่านชนิดสเก็ตช์จากการจัดรูปแบบเส้นที่มีผลกลับมาดังที่แสดงด้านล่าง ค่าที่มีผลสะท้อนการจัดรูปแบบที่นำไปใช้จริงหลังจากการสืบทอดได้รับการแก้ไข ตัวอย่างนี้ต้องมีการนำเสนอที่มีรูปร่างอย่างน้อยหนึ่งรูปบนสไลด์แรกและพิมพ์ค่าทั้งสอง:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation
presentation = Presentation("presentation.pptx")
try:
shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0)
line_format = shape.getLineFormat()
explicit_sketch_type = line_format.getSketchFormat().getSketchType()
effective_line_format = line_format.getEffective()
effective_sketch_type = effective_line_format.getSketchFormat().getSketchType()
print("Explicit sketch type:", explicit_sketch_type)
print("Effective sketch type:", effective_sketch_type)
finally:
presentation.dispose()
จัดรูปแบบสไตล์การเชื่อมต่อ
นี่คือสามตัวเลือกประเภทการเชื่อมต่อ:
- Round
- Miter
- Bevel
สไตล์การเชื่อมต่อควบคุมว่าตัวแบ่งเส้นสองเส้นมาบรรจบกันที่มุมอย่างไร ใช้ Round สำหรับมุมโค้ง, Miter สำหรับมุมแหลม, หรือ Bevel สำหรับมุมแบน

ตัวอย่างนี้สร้างสี่เหลี่ยมสีดำสามรูปโดยมีเส้นขอบสีน้ำเงินความกว้าง 15 จุด ใช้ LineFormat.setJoinStyle เพื่อกำหนดค่า miter, bevel, และ round ของ LineJoinStyle ตามลำดับเพื่อเปรียบเทียบว่ามุมถูกวาดอย่างไร
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineJoinStyle, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
miter_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 75)
bevel_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 210, 20, 150, 75)
round_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 135, 150, 75)
miter_shape.getFillFormat().setFillType(FillType.Solid)
miter_shape.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
bevel_shape.getFillFormat().setFillType(FillType.Solid)
bevel_shape.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
round_shape.getFillFormat().setFillType(FillType.Solid)
round_shape.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
miter_shape.getLineFormat().setWidth(15)
bevel_shape.getLineFormat().setWidth(15)
round_shape.getLineFormat().setWidth(15)
miter_shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
miter_shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
bevel_shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
bevel_shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
round_shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
round_shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
miter_shape.getLineFormat().setJoinStyle(LineJoinStyle.Miter)
bevel_shape.getLineFormat().setJoinStyle(LineJoinStyle.Bevel)
round_shape.getLineFormat().setJoinStyle(LineJoinStyle.Round)
miter_shape.getTextFrame().setText("Miter Join Style")
bevel_shape.getTextFrame().setText("Bevel Join Style")
round_shape.getTextFrame().setText("Round Join Style")
presentation.save("join_styles.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
จำกัดการเชื่อมต่อ Miter ที่มุมแหลม
ใช้ LineFormat.setMiterLimit พร้อมกับ LineFormat.setJoinStyle ตั้งค่าเป็น LineJoinStyle.Miter เพื่อจำกัดระยะที่มุมแหลมสามารถขยายออกไปได้
ค่าจำกัดเป็นอัตราส่วนของระยะห่างระหว่างมุมในและมุมนอกของการเชื่อมต่อต่อความกว้างของเส้น ตัวอย่างเช่น ค่า 8 อนุญาตให้ความยาวของมิตเทอร์สูงถึง 8 เท่าของความกว้างของเส้น; มันไม่ใช่การวัดเป็นจุด หากมุมเกินค่าจำกัด PowerPoint จะใช้การเชื่อมต่อแบบบีเวิลที่มุมนั้น ค่าจำกัดที่ใหญ่กว่าจะทำให้จุดคมขึ้น การตั้งค่านี้มีผลต่อการเชื่อมต่อแบบมิตเทอร์เท่านั้นและการเปลี่ยนแปลงจะไม่มีผลที่มองเห็นได้เมื่อมุมยังคงอยู่ภายในขีดจำกัดทั้งสอง
ตัวอย่างนี้สร้างสองสามเหลี่ยมที่เหมือนกันโดยไม่มีการเติมสีโดยมีเส้นขอบความกว้าง 20 จุด สามเหลี่ยมซ้ายใช้ค่าจำกัด 2 และด้านขวาใช้ 8 แต่ละสามเหลี่ยมกว้าง 80 จุด สูง 160 จุด ทำให้มุมบนมีอัตราส่วนความยาวมิตเทอร์ต่อความกว้างเส้นประมาณ 4.12 ดังนั้น PowerPoint จะบีเวิลยอดซ้ายและคงยอดขวาไว้
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineJoinStyle, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(500, 320, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
miter_limits = [2.0, 8.0]
for i, miter_limit in enumerate(miter_limits):
triangle = slide.getShapes().addAutoShape(ShapeType.Triangle, 90 + i * 240, 110, 80, 160)
triangle.getFillFormat().setFillType(FillType.NoFill)
triangle.getLineFormat().setWidth(20)
triangle.getLineFormat().getFillFormat().setFillType(FillType.Solid)
color = Color(0, 0, 139)
triangle.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
triangle.getLineFormat().setJoinStyle(LineJoinStyle.Miter)
triangle.getLineFormat().setMiterLimit(miter_limit)
presentation.save("miter_limits.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์ใน PowerPoint: Miter limit 2 ทางซ้ายและ miter limit 8 ทางขวา

การไล่สี
การไล่สีผสมสีหลายสีทั่วรูปร่าง ตัวอย่างนี้เติมวงรีด้วยไล่สีเชิงเส้นที่มุม 45 องศาจากสีแดงไปสีม่วงโดยใช้ FillFormat.getGradientFormat เมธอด GradientStopCollection.addPresetColor วางจุดสีที่ 0 และ 1 คือจุดเริ่มต้นและจุดสิ้นสุดของการไล่สี การล้างจุดสีที่มีอยู่เดิมทำให้ใช้เฉพาะสองสีนี้เท่านั้น
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, GradientShape, Presentation, PresetColor, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 50, 50, 150, 75)
shape.getFillFormat().setFillType(FillType.Gradient)
shape.getFillFormat().getGradientFormat().setGradientShape(GradientShape.Linear)
shape.getFillFormat().getGradientFormat().setLinearGradientAngle(45)
shape.getFillFormat().getGradientFormat().getGradientStops().clear()
shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(1.0, PresetColor.Purple)
shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(0.0, PresetColor.Red)
presentation.save("gradient_fill.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์:

หากการไล่สีดูแตกต่างกันในภาพที่ส่งออกกับใน PowerPoint ดูที่ Choose a Gradient Rendering Style คุณสามารถเลือกสไตล์การเรนเดอร์โดยไม่ต้องเปลี่ยนการไล่สีที่เก็บในงานนำเสนอ
ตั้งมุมไล่สีเชิงเส้น
ใช้ GradientFormat.setLinearGradientAngle เพื่อควบคุมทิศทางของการเติม GradientShape.Linear มุมวัดเป็นองศาและเพิ่มตามเข็มนาฬิกา: 0 วิ่งจากซ้ายไปขวา, 90 จากบนลงล่าง, 180 จากขวาไปซ้าย, และ 270 จากล่างขึ้นบน สามเหลี่ยมมุมอาจใช้ได้ มุมที่อยู่นอกช่วง [0, 360) จะปรับให้เป็นรอบหนึ่ง ตัวอย่างเช่น -45 จะเป็น 315 และ 360 จะเป็น 0
ตัวอย่างนี้สร้างสี่เหลี่ยมสีหกรูปโดยมีจุดสีแดง เขียว และน้ำเงินที่ตำแหน่ง 0, 0.5, และ 1 เหมือนกัน การสเกลปิดเพื่อให้มุมเปรียบเทียบได้โดยอิสระจากสัดส่วนของสี่เหลี่ยม มุมจากซ้ายไปขวาในแถวแรกคือ 0, 45, และ 90 และในแถวล่างคือ 135, 180, และ 270
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, GradientShape, NullableBool, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(720, 400, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
angles = [0, 45, 90, 135, 180, 270]
for i, angle in enumerate(angles):
x = 30 + (i % 3) * 230
y = 30 + (i // 3) * 190
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, x, y, 200, 150)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
shape.getFillFormat().setFillType(FillType.Gradient)
gradient = shape.getFillFormat().getGradientFormat()
gradient.setGradientShape(GradientShape.Linear)
gradient.getGradientStops().clear()
gradient.getGradientStops().add(0, Color.RED)
gradient.getGradientStops().add(0.5, Color.GREEN)
gradient.getGradientStops().add(1, Color.BLUE)
gradient.setLinearGradientScaled(NullableBool.False_)
gradient.setLinearGradientAngle(angle)
presentation.save("linear_gradient_angles.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์ใน PowerPoint:

สเกลไล่สีเชิงเส้นกับรูปทรง
GradientFormat.setLinearGradientScaled รับค่า NullableBool ตั้งค่าอย่างชัดเจนเป็น False_ เพื่อคงมุมไล่สีเรขาคณิตเมื่อตัวรูปทรงเปลี่ยนสัดส่วน หรือเป็น True_ เพื่อสเกลไล่สีตามความกว้างและสูงของรูปทรง เมื่อสเกลเปิดใช้งานมุมที่มองเห็นอาจต่างจากมุมที่กำหนดบนรูปทรงที่ไม่เป็นสี่เหลี่ยมจัตุรัส
ตัวอย่างต่อไปนี้ใช้มุม 45 องศาและจุดสีเดียวกับการเปรียบเทียบมุม คอลัมน์ซ้ายใช้ False_; คอลัมน์ขวาใช้ True_ แต่ละคอลัมน์มีสี่เหลี่ยมกว้างเหนือสี่เหลี่ยมสูง ทั้งสองเริ่มจากขนาดกว้างเดียวกัน; การเปลี่ยนความกว้างและสูงของสี่เหลี่ยมที่สองแสดงว่าการเติมสีตอบสนองต่อการปรับขนาดอย่างไรโดยไม่เปลี่ยนการตั้งค่าไล่สี
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, GradientShape, NullableBool, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(720, 460, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
scaling_options = [NullableBool.False_, NullableBool.True_]
for column, scaled in enumerate(scaling_options):
for row in range(2):
x = 30 + column * 360
y = 30 if row == 0 else 150
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, x, y, 300, 90)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
shape.getFillFormat().setFillType(FillType.Gradient)
gradient = shape.getFillFormat().getGradientFormat()
gradient.setGradientShape(GradientShape.Linear)
gradient.getGradientStops().clear()
gradient.getGradientStops().add(0, Color.RED)
gradient.getGradientStops().add(0.5, Color.GREEN)
gradient.getGradientStops().add(1, Color.BLUE)
gradient.setLinearGradientAngle(45)
gradient.setLinearGradientScaled(scaled)
if row == 1:
shape.setWidth(90)
shape.setHeight(280)
presentation.save("linear_gradient_scaling.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์ใน PowerPoint, ปิดการสเกลทางซ้ายและเปิดบนทางขวา:

เมื่อสเกลปิด การไล่สีทแยงมุมจะคงทิศทางเดียวกันในทั้งสองสี่เหลี่ยม เมื่อสเกลเปิด แถบสีจะยืดตามสัดส่วนของรูปทรง ซึ่งช่วยทำซ้ำไล่สีของเทมเพลตเมื่อปรับรูปทรงให้มีขนาดต่างกัน บนสี่เหลี่ยมจัตุรัส การเปิดสเกลไม่ทำให้ไล่สี 45‑องศานี้เปลี่ยนรูปลักษณ์
การตั้งค่ามุมและสเกลใช้ได้กับไล่สีเชิงเส้นเท่านั้น ไม่ควบคุมการเติม GradientShape.Radial หรือ GradientShape.Rectangle
รวมมุมกับทิศทางของไล่สี
GradientFormat.setGradientDirection เลือกรูปแบบไล่สีจากคลาส GradientDirection ซึ่งไม่เป็นตัวแทนของมุมเชิงตัวเลข สำหรับไล่สีเชิงเส้น สไตล์มุมอาจเปลี่ยนพื้นที่ที่สีกระจายโดยไม่ต้องเปลี่ยนมุมที่กำหนดผ่าน setLinearGradientAngle คงทิศทางเมื่อเปรียบเทียบมุมหรือสเกล
ตัวอย่างต่อไปนี้ใช้การตั้งค่าเดียวกันแต่สั่งลำดับตรงกันข้าม สี่เหลี่ยมทั้งสองมีลักษณะเดียวกัน: การกำหนดทิศทางก่อนหรือหลังมุมไม่ได้เปลี่ยนผลลัพธ์
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, GradientDirection, GradientShape, NullableBool, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
for i in range(2):
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 30 + i * 140, 320, 100)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
shape.getFillFormat().setFillType(FillType.Gradient)
gradient = shape.getFillFormat().getGradientFormat()
gradient.setGradientShape(GradientShape.Linear)
gradient.getGradientStops().clear()
gradient.getGradientStops().add(0, Color.RED)
gradient.getGradientStops().add(0.5, Color.GREEN)
gradient.getGradientStops().add(1, Color.BLUE)
gradient.setLinearGradientScaled(NullableBool.True_)
if i == 0:
gradient.setGradientDirection(GradientDirection.FromCorner1)
gradient.setLinearGradientAngle(30)
else:
gradient.setLinearGradientAngle(30)
gradient.setGradientDirection(GradientDirection.FromCorner1)
presentation.save("linear_gradient_direction.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
การเติมลาย
การเติมลายใช้การออกแบบสองสี เช่น จุด, เส้นแนวนอนหรือเชิงกริด ตัวอย่างนี้ใช้ PatternFormat.setPatternStyle เพื่อเลือกลาย trellis PatternFormat.getBackColor ให้พื้นหลังสีเทาอ่อน และ PatternFormat.getForeColor ให้สีเหลืองสำหรับลาย
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, PatternStyle, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
shape.getFillFormat().setFillType(FillType.Pattern)
shape.getFillFormat().getPatternFormat().setPatternStyle(PatternStyle.Trellis)
shape.getFillFormat().getPatternFormat().getBackColor().setColor(Color.LIGHT_GRAY)
shape.getFillFormat().getPatternFormat().getForeColor().setColor(Color.YELLOW)
presentation.save("pattern_fill.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์:

การเติมภาพ
การเติมภาพใช้รูปภาพภายในรูปร่าง ตัวอย่างนี้ต้องการรูปภาพแบบท้องถิ่นและใช้ Images.fromFile เพื่อโหลดเข้าคอลเลกชันภาพของงานนำเสนอ การตั้งค่า PictureFillFormat.setPictureFillMode เป็นโหมดกระเบื้องจะทำซ้ำรูปภาพภายในสี่เหลี่ยม รูปภาพต้นฉบับที่ใช้แสดงด้านล่าง:

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Images, PictureFillMode, Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 255, 130)
shape.getFillFormat().setFillType(FillType.Picture)
shape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Tile)
image = Images.fromFile("lotus.png")
try:
picture = presentation.getImages().addImage(image)
finally:
image.dispose()
shape.getFillFormat().getPictureFillFormat().getPicture().setImage(picture)
presentation.save("picture_fill.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์:

ทำภาพเป็นพื้นผิวแบบปูกระเบื้อง
หากต้องการตั้งรูปภาพเป็นพื้นผิวแบบกระเบื้องและปรับพฤติกรรมการปูกระเบื้อง คุณสามารถใช้เมธอดต่อไปนี้ของคลาส PictureFillFormat :
- setPictureFillMode: ตั้งโหมดการเติมภาพ —
TileหรือStretch - setTileAlignment: ระบุการจัดตำแหน่งของกระเบื้องภายในรูปร่าง
- setTileFlip: ควบคุมว่ากระเบื้องจะถูกพลิกแนวนอน แนวตั้ง หรือทั้งสองอย่าง
- setTileOffsetX: ตั้งค่าการเลื่อนแนวนอนของกระเบื้อง (เป็นจุด) จากต้นตอของรูปร่าง
- setTileOffsetY: ตั้งค่าการเลื่อนแนวตั้งของกระเบื้อง (เป็นจุด) จากต้นตอของรูปร่าง
- setTileScaleX: กำหนดสเกลแนวนอนของกระเบื้องเป็นเปอร์เซ็นต์
- setTileScaleY: กำหนดสเกลแนวตั้งของกระเบื้องเป็นเปอร์เซ็นต์
ตัวอย่างนี้ต้องการรูปภาพแบบท้องถิ่นและกำหนดค่า PictureFillFormat ให้ทำซ้ำที่ 50 % ของขนาดต้นฉบับ การเลื่อน −32 จุดทำให้กระเบื้องย้ายแนวนอนและแนวตั้ง; การจัดตำแหน่งด้านล่าง‑ขวาและการพลิกทั้งสองทิศทางกำหนดวิธีการเรียงลำดับของพื้นผิวที่ทำซ้ำ
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Images, PictureFillMode, Presentation, RectangleAlignment, SaveFormat, ShapeType, TileFlip
presentation = Presentation()
try:
first_slide = presentation.getSlides().get_Item(0)
shape = first_slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 190, 95)
shape.getFillFormat().setFillType(FillType.Picture)
source_image = Images.fromFile("lotus.png")
try:
presentation_image = presentation.getImages().addImage(source_image)
finally:
source_image.dispose()
picture_fill_format = shape.getFillFormat().getPictureFillFormat()
picture_fill_format.getPicture().setImage(presentation_image)
picture_fill_format.setPictureFillMode(PictureFillMode.Tile)
picture_fill_format.setTileOffsetX(-32)
picture_fill_format.setTileOffsetY(-32)
picture_fill_format.setTileScaleX(50)
picture_fill_format.setTileScaleY(50)
picture_fill_format.setTileAlignment(RectangleAlignment.BottomRight)
picture_fill_format.setTileFlip(TileFlip.FlipBoth)
presentation.save("tile.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์:

การเติมสีทึบ
การเติมสีทึบให้รูปร่างเป็นสีเดียวเดียวที่สม่ำเสมอ ตัวอย่างนี้ใช้ FillFormat.setFillType เพื่อกำหนดโหมดเติมสีทึบและกำหนดสีเหลืองผ่าน FillFormat.getSolidFillColor แล้วบันทึกสี่เหลี่ยมในงานนำเสนอ
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
shape.getFillFormat().setFillType(FillType.Solid)
shape.getFillFormat().getSolidFillColor().setColor(Color.YELLOW)
presentation.save("solid_color_fill.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์:

คัดลอกรสีขณะคงการอ้างอิงธีม
ใช้ ColorFormat.copyFrom เพื่อคัดลอกคำจำกัดความสีรวมถึงประเภทสี, การอ้างอิงธีมและการแปลง นี่เป็นประโยชน์เมื่อย้ายสีเติมระหว่างรูปร่างที่ควรยังคงตามธีมของงานนำเสนอเมธอดจะคัดลอกเฉพาะสี ไม่คัดลอกประเภทการเติม, เส้นขอบหรือการจัดรูปแบบอื่น ๆ ของรูปร่าง กำหนดประเภทการเติมของปลายทางอย่างชัดเจนด้วย FillFormat.setFillType
ตัวอย่างนี้สร้างสี่เหลี่ยมสามรูปจากซ้ายไปขวา: ต้นฉบับ, สำเนาที่รับรู้ธีม, และสำเนา RGB คงที่ ต้นฉบับใช้ ColorFormat.setSchemeColor เพื่ออ้างอิงสีเน้นแรกและเพิ่มการเบลอด้วย ColorOperationCollection.add สำเนา RGB ใช้สีเติมที่มีผลของต้นฉบับเพื่อให้ทั้งสามดูเหมือนกันในตอนแรก การเรียก ColorFormat.setColor จะตั้งค่า RGB คงที่และลบการแปลงสีที่มีอยู่
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import ColorTransformOperation, FillType, ImageFormat, Presentation, SaveFormat, SchemeColor, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(660, 220, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
accent_color = Color(65, 105, 225)
presentation.getMasterTheme().getColorScheme().getAccent1().setColor(accent_color)
source = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 40, 180, 140)
theme_copy = slide.getShapes().addAutoShape(ShapeType.Rectangle, 240, 40, 180, 140)
rgb_copy = slide.getShapes().addAutoShape(ShapeType.Rectangle, 450, 40, 180, 140)
for shape in (source, theme_copy, rgb_copy):
shape.getFillFormat().setFillType(FillType.Solid)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
source_color = source.getFillFormat().getSolidFillColor()
source_color.setSchemeColor(SchemeColor.Accent1)
source_color.getColorTransform().add(ColorTransformOperation.Tint, 0.75)
theme_copy.getFillFormat().getSolidFillColor().copyFrom(source_color)
rgb_copy.getFillFormat().getSolidFillColor().setColor(source.getFillFormat().getEffective().getSolidFillColor())
before = slide.getImage(1.0, 1.0)
try:
before.save("color-copy-before.png", ImageFormat.Png)
finally:
before.dispose()
# การอ้างอิงธีมจะตามสีเน้นใหม่; ค่ารหัส RGB คงที่จะไม่ทำเช่นนั้น.
accent_color = Color(255, 69, 0)
presentation.getMasterTheme().getColorScheme().getAccent1().setColor(accent_color)
after = slide.getImage(1.0, 1.0)
try:
after.save("color-copy-after.png", ImageFormat.Png)
finally:
after.dispose()
presentation.save("copied_colors.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ก่อนการเปลี่ยนธีม ทั้งสามการเติมสีตรงกัน:

หลังการเปลี่ยนธีม แหล่งที่มาและสำเนาที่รับรู้ธีมจะใช้สีเน้นใหม่และคงการผสมสีเดิมไว้ ส่วนสำเนา RGB คงที่ยังคงเป็นสีน้ำเงิน:

การคัดลอกคำนิยามเป็นอิสระจากต้นฉบับ การเปลี่ยนการอ้างอิงธีมของต้นฉบับ, กำหนดสีอื่น หรือเพิ่ม/ลบการแปลงจะไม่ส่งผลต่อปลายทาง การเปลี่ยนธีมยังคงมีผลต่อรูปร่างทั้งสองเพราะแต่ละรูปร่างอ้างอิงสีธีมเดียวกัน
การบันทึกและเปิดไฟล์ PPTX อีกครั้งจะคงประเภทสีที่คัดลอกได้จาก ColorFormat.getColorType, การอ้างอิงธีม และคอลเลกชันการแปลงจาก ColorFormat.getColorTransform ; ไม่ได้แปลงเป็น RGB
เมือคัดลอกระหว่างบริบทธีมที่ต่างกัน เช่น งานนำเสนอที่ใช้พาเลตต์สีเน้นต่างกัน การอ้างอิงที่คัดลอกจะอิงกับธีมของปลายทาง การอ้างอิงและการแปลงเดียวกันอาจให้สีที่มองเห็นแตกต่าง ดูที่ Presentation Theme เพื่อเรียนรู้การกำหนดสีธีม
ใช้พื้นหลังสไลด์เป็นการเติมสีให้รูปร่าง
ใช้ AutoShape.setUseBackgroundFill เมื่อรูปร่างควรตรงกับพื้นหลังสไลด์ ตัวอย่างเช่น ในเทมเพลตงานนำเสนอ กำหนดประเภทการเติมด้วย FillFormat.setFillType เป็น FillType.NotDefined ก่อนเพื่อลบการเติมที่กำหนดโดยชัดเจน ด้วยการผสมนี้รูปร่างจะใช้พื้นหลังสไลด์แทนการเติมสไตล์ของตน การเปิดใช้งานแฟลกเพียงอย่างเดียวไม่ได้ลบการเติมที่กำหนดไว้แล้ว
สิ่งนี้แตกต่างจาก FillType.NoFill : การเติมพื้นหลังจะครอบคลุมวัตถุที่อยู่ด้านหลังรูปร่างด้วยพื้นที่ของพื้นหลังสไลด์ที่สอดคล้องกัน ส่วน NoFill จะทำให้วัตถุเหล่านั้นมองเห็นได้ การไล่สียังคงจัดแนวกับสไลด์แทนที่จะแตกใหม่ภายในแต่ละรูปร่าง
ตัวอย่างต่อไปนี้สร้างพื้นหลังมาสเตอร์ที่สืบทอดโดยสไลด์และวางแถบสีแมจนท์ไว้หลังสี่เหลี่ยมสามรูป สี่เหลี่ยมซ้ายใช้พื้นหลัง, สี่เหลี่ยมกลางไม่มีการเติม, และสี่เหลี่ยมขวาสลับจากการเติมพื้นหลังเป็นการเติมสีส้มชัดเจน
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BackgroundType, FillType, GradientShape, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(720, 400, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
# สืบทอดการไล่สีจากมาสเตอร์.
slide.getBackground().setType(BackgroundType.NotDefined)
slide.getLayoutSlide().getBackground().setType(BackgroundType.NotDefined)
background = slide.getLayoutSlide().getMasterSlide().getBackground()
background.setType(BackgroundType.OwnBackground)
background.getFillFormat().setFillType(FillType.Gradient)
gradient = background.getFillFormat().getGradientFormat()
gradient.setGradientShape(GradientShape.Linear)
gradient.setLinearGradientAngle(0)
gradient.getGradientStops().clear()
color = Color(0, 0, 139)
gradient.getGradientStops().add(0, color)
color = Color(135, 206, 250)
gradient.getGradientStops().add(1, color)
# เพิ่มวัตถุนี้ก่อนเพื่อให้แสดงด้านหลังสี่เหลี่ยม.
band = slide.getShapes().addAutoShape(ShapeType.Rectangle, 25, 150, 670, 100)
band.getFillFormat().setFillType(FillType.Solid)
band.getFillFormat().getSolidFillColor().setColor(Color.MAGENTA)
band.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
background_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 100, 160, 200)
background_shape.getFillFormat().setFillType(FillType.NotDefined)
background_shape.setUseBackgroundFill(True)
no_fill_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 280, 100, 160, 200)
no_fill_shape.getFillFormat().setFillType(FillType.NoFill)
explicit_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 510, 100, 160, 200)
explicit_shape.getFillFormat().setFillType(FillType.NotDefined)
explicit_shape.setUseBackgroundFill(True)
# ปิดการเติมพื้นหลังก่อนที่จะใช้การเติมที่กำหนดเอง.
explicit_shape.setUseBackgroundFill(False)
explicit_shape.getFillFormat().setFillType(FillType.Solid)
color = Color(255, 165, 0)
explicit_shape.getFillFormat().getSolidFillColor().setColor(color)
presentation.save("background_fill.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์จากซ้ายไปขวา: background fill, no fill, และ explicit fill. แถบสีแมจนท์ถูกซ่อนโดยสี่เหลี่ยมซ้ายและขวาแต่ยังคงมองเห็นผ่านสี่เหลี่ยมกลาง

พฤติกรรมเดียวกันใช้กับพื้นหลังที่กำหนดโดยตรงบนสไลด์หรือสืบทอดจากเลเอาต์ รูปร่างใช้พื้นหลังที่แก้ไขแล้วของสไลด์; ตัวอย่างนี้ทำให้พื้นหลังของสไลด์และเลเอาต์เป็นค่าไม่กำหนดเพื่อให้มาสเตอร์จัดการให้
ตั้งค่าความโปร่งใส
สำหรับการเติมสีทึบ ส่วนประกอบอัลฟาของสีควบคุมความทึบ: 0 คือโปร่งใสเต็มที่และ 255 คือทึบเต็มที่ ตัวอย่างนี้ใช้ค่าอัลฟา 128 สำหรับสี่เหลี่ยมสีเหลือง ทำให้โปร่งใสประมาณ 50 % เพื่อให้สี่เหลี่ยมด้านล่างมองเห็นได้ สีกำหนดผ่าน FillFormat.getSolidFillColor
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
solid_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
transparent_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 80, 80, 150, 75)
transparent_shape.getFillFormat().setFillType(FillType.Solid)
color = Color(255, 255, 0, 128)
transparent_shape.getFillFormat().getSolidFillColor().setColor(color)
presentation.save("shape_transparency.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์:

หมุนรูปร่าง
ใช้ Shape.setRotation เพื่อหมุนรูปร่างในระนาบสไลด์ มุมวัดเป็นองศา ตัวอย่างนี้หมุนสี่เหลี่ยม 5 องศาตามเข็มนาฬิกาและบันทึกงานนำเสนอ
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
shape.setRotation(5)
presentation.save("shape_rotation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์:

เพิ่มเอฟเฟกต์บีเวิล 3 มิติ
ใช้ Shape.getThreeDFormat ให้รูปร่างมีความลึกและขอบบีเวิล ตัวอย่างนี้สร้างวงรีสีเขียวโดยมีเส้นขอบส้ม ใช้ ThreeDFormat.setDepth ตั้งความลึกเป็น 4 จุดและใช้ ThreeDFormat.getBevelTop เพื่อสร้างบีเวิลบนแบบวงกลมที่กว้างและสูง 6 จุด กล้องออร์โธกราฟิกที่หันหน้าและแสงสามจุดทำให้บีเวิลมองเห็น
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BevelPresetType, CameraPresetType, FillType, LightRigPresetType, LightingDirection, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 50, 50, 100, 100)
shape.getFillFormat().setFillType(FillType.Solid)
color = Color(0, 128, 0)
shape.getFillFormat().getSolidFillColor().setColor(color)
shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
color = Color(255, 165, 0)
shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
shape.getLineFormat().setWidth(2.0)
shape.getThreeDFormat().setDepth(4)
shape.getThreeDFormat().getBevelTop().setBevelType(BevelPresetType.Circle)
shape.getThreeDFormat().getBevelTop().setHeight(6)
shape.getThreeDFormat().getBevelTop().setWidth(6)
shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront)
shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.ThreePt)
shape.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top)
presentation.save("3D_bevel_effect.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์:

เพิ่มเอฟเฟกต์การหมุน 3 มิติ
มุมมอง 3 มิติของรูปร่างถูกควบคุมด้วยการตั้งค่ากล้อง ตัวอย่างนี้ใช้ Camera.setRotation ตั้งมุมละติจูด, ลองจิจูดและการหมุนรอบที่ 40, 35, และ 20 องศาตามลำดับ เลือกกล้องไอโซเมตริกด้วย Camera.setCameraType และแสงสมดุลด้วย LightRig.setLightType แล้วบันทึกสี่เหลี่ยมที่จัดรูปแบบ
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import CameraPresetType, LightRigPresetType, Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
auto_shape.getTextFrame().setText("Hello, Aspose!")
auto_shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.IsometricLeftUp)
auto_shape.getThreeDFormat().getCamera().setRotation(40, 35, 20)
auto_shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Balanced)
presentation.save("3D_rotation_effect.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ผลลัพธ์:

ควบคุมการแสดงผลขาว‑ดำสำหรับรูปร่าง
เมธอด Shape.setBlackWhiteMode ระบุว่ารูปร่างแต่ละอันจะถูกแสดงอย่างไรเมื่อดูหรือประมวลผลงานนำเสนอในโหมดขาว‑ดำ มันไม่เปิดใช้งานการแสดงผลขาว‑ดำโดยอัตโนมัติและไม่เปลี่ยนการเติม, เส้น หรือการจัดรูปแบบอื่นของรูปร่างในโหมดสีปกติ
ใช้ค่าจากคลาส BlackWhiteMode เพื่อเลือกพฤติกรรมที่ต้องการ ตัวอย่างเช่น Automatic ให้แอพพลิเคชันเลือกการแปลง, Gray และ LightGray ใช้สีเทา, BlackWhite ใช้เฉพาะสีดำและขาว, Black และ White บังคับสีเดียว, Color คงสีปกติ, และ Hidden ลบรูปร่างในโหมดขาว‑ดำ NotDefined หมายถึงไม่ได้กำหนดโหมดระดับรูปร่าง
ตัวอย่างนี้สร้างสี่เหลี่ยมส้มและใช้ Shape.setBlackWhiteMode ตั้งโหมดเป็น Gray รูปร่างที่บันทึกยังคงเติมสีส้มสำหรับการแสดงสีปกติและขอให้แอพพลิเคชันที่เคารพการแสดงผลขาว‑ดำใช้สีเทา:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BlackWhiteMode, FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 200, 100)
shape.getFillFormat().setFillType(FillType.Solid)
color = Color(255, 165, 0)
shape.getFillFormat().getSolidFillColor().setColor(color)
shape.setBlackWhiteMode(BlackWhiteMode.Gray)
presentation.save("shape_black_white_mode.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ในโหมดสีปกติ สี่เหลี่ยมยังคงเติมสีส้ม ในขั้นตอนแสดงผลขาว‑ดำ มันใช้สีเทาจากที่ตั้งค่าเป็น Gray สิ่งนี้ช่วยให้คุณคงสไลด์สีเต็มเมื่อกำหนดลักษณะเฉพาะสำหรับการพิมพ์, ดูตัวอย่างหรือขั้นตอนอื่นที่เคารพการตั้งค่าการแสดงผลขาว‑ดำของงานนำเสนอ
รีเซ็ตการจัดรูปแบบ
ใช้ Slide.reset เพื่อคืนตำแหน่ง, ขนาด และการจัดรูปแบบของตำแหน่งตัวยึดสไลด์จากตำแหน่งตัวยึดของเลเอาต์ที่สอดคล้อง ตัวอย่างนี้ต้องการงานนำเสนอที่มีตำแหน่งตัวยึดเชื่อมโยงกับเลเอาต์และรีเซ็ตทุกสไลด์ก่อนบันทึก รูปร่างที่ไม่มีตำแหน่งตัวยึดในเลเอาต์จะไม่ถูกรีเซ็ต
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("sample.pptx")
try:
for slide in presentation.getSlides():
slide.reset()
presentation.save("reset_formatting.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
คำถามที่พบบ่อย
การจัดรูปแบบรูปร่างมีผลต่อขนาดไฟล์งานนำเสนอสุดท้ายหรือไม่?
สี, สไตล์เส้นและการตั้งค่าเอฟเฟกต์โดยทั่วไปเพิ่มข้อมูลเพียงเล็กน้อยเมื่อเทียบกับภาพและสื่อที่ฝังอยู่ การเติมภาพอาจเพิ่มขนาดไฟล์เพราะภาพถูกเก็บในงานนำเสนอ
ฉันจะตรวจจับรูปร่างบนสไลด์ที่มีการจัดรูปแบบเดียวกันเพื่อที่จะจัดกลุ่มได้อย่างไร?
เปรียบเทียบคุณสมบัติการจัดรูปแบบหลักของแต่ละรูปร่าง — การเติม, เส้นและการตั้งค่าเอฟเฟกต์ หากค่าตรงกันทั้งหมด ให้ถือว่าสไตล์เดียวกันและจัดกลุ่มรูปร่างเหล่านั้นเชิงตรรกะ ซึ่งช่วยลดความซับซ้อนในการจัดการสไตล์ในภายหลัง
ฉันสามารถบันทึกชุดสไตล์รูปร่างแบบกำหนดเองเป็นไฟล์แยกเพื่อใช้ใหม่ในงานนำเสนออื่นได้หรือไม่?
ได้. เก็บตัวอย่างรูปร่างที่มีสไตล์ที่ต้องการในเทมเพลตสไลด์หรือไฟล์เทมเพลต .POTX เมื่อสร้างงานนำเสนอใหม่ เปิดเทมเพลต, คัดลอกรูปร่างที่สไตล์ต้องการและนำการจัดรูปแบบไปใช้ใหม่ตามที่ต้องการ