Aspose.Slides for PHP via Java 26.3 Release Notes

$presentation = new Presentation("example.pptx");

$shape = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item(0);

$visualBounds = $shape->getVisualBounds();

echo "Visual bounds: X=" . $visualBounds->getX() . ", Y=" . $visualBounds->getY() .
     ", Width=" . $visualBounds->getWidth() . ", Height=" . $visualBounds->getHeight() . "\n";

$presentation->dispose();

$presentation = new Presentation("FillColor.pptx");

$shapeIter = $presentation->getSlides()->get_Item(0)->getShapes()->iterator();
while (java_values($shapeIter->hasNext())) {
	$shape = $shapeIter->next();
    $fillFormat = $shape->getFillFormat()->getEffective();
    echo "Fill color: " . $fillFormat->getSolidFillColor() . "\n";
    echo "Fill scheme color: " . $fillFormat->getSolidFillSchemeColor() . "\n";
}

$presentation->dispose();

/**
 * <p>
 * Microsoft PowerPoint 97-2003 Presentation (*.ppt).
 * </p>
 */
public static final int Ppt = 0;

/**
 * <p>
 * Microsoft Office Open XML Presentation (*.pptx).
 * </p>
 */
public static final int Pptx = 1;

/**
 * <p>
 * OpenDocument Presentation (*.odp).
 * </p>
 */
public static final int Odp = 2;

/**
 * <p>
 * Microsoft Office Open XML Macro-enabled Presentation (*.pptm).
 * </p>
 */
public static final int Pptm = 3;

/**
 * <p>
 * Microsoft Office Open XML SlideShow (*.ppsx).
 * </p>
 */
public static final int Ppsx = 4;

/**
 * <p>
 * Microsoft Office Open XML Macro-enabled SlideShow (*.ppsm).
 * </p>
 */
public static final int Ppsm = 5;

/**
 * <p>
 * Microsoft Office Open XML Template (*.potx).
 * </p>
 */
public static final int Potx = 6;

/**
 * <p>
 * Microsoft Office Open XML Macro-enabled Template (*.potm).
 * </p>
 */
public static final int Potm = 7;

/**
 * <p>
 * Microsoft PowerPoint 97-2003 SlideShow (*.pps).
 * </p>
 */
public static final int Pps = 8;

/**
 * <p>
 * Microsoft PowerPoint 97-2003 Template (*.pot).
 * </p>
 */
public static final int Pot = 9;

/**
 * <p>
 * OpenDocument Presentation Template (*.otp).
 * </p>
 */
public static final int Otp = 10;

/**
 * <p>
 * Flat XML ODF Presentation (*.fodp).
 * </p>
 */
public static final int Fodp = 11;

/**
 * <p>
 * PowerPoint XML Presentation (*.xml).
 * </p>
 */
public static final int Xml = 12;

/**
 * <p>
 * Converts a source file format to the corresponding {@link SaveFormat}.
 * </p>
 * @return The corresponding {@link SaveFormat} value.
 * @exception ArgumentException 
 * @param format The source file format.
 */
public static int toSaveFormat(int format)

$sourcePresentation = new Presentation("SomePresentation.pptm");

// Modify the presentation as you need
$sourcePresentation->getSlides()->addClone($sourcePresentation->getSlides()->get_Item(0));

// Save the presentation to the stream in its original format
$stream = new Java("java.io.ByteArrayOutputStream");
$sourcePresentation->save($stream, SlideUtil::toSaveFormat($sourcePresentation->getSourceFormat()));

$sourcePresentation->dispose();

/**
 * <p>
 * Gets an array of points that define the geometry of the element's path.
 * </p>
 */
public final Point2D.Float[] getPathPoints() 

/**
 * <p>
 * Gets an array of byte values that specify the type of each point in the element's path. 
 * <p><b>0</b> Indicates that the point is the start of a figure.</p>
 * <p><b>1</b> Indicates that the point is one of the two endpoints of a line.</p>
 * <p><b>3</b> Indicates that the point is an endpoint or control point of a cubic Bezier spline.</p>
 * <p><b>7</b> Masks all bits except for the three low-order bits, which indicate the point type.</p>
 * <p><b>16</b> Specifies that the corresponding segment is dashed.</p>
 * <p><b>32</b> Specifies that the point is a marker.</p>
 * <p><b>128</b> Specifies that the point is the last point in a closed subpath (figure).</p>
 * <p><b>129</b> Indicates a data point that is both a line segment endpoint and the last point of a closed subpath.</p>
 * </p>
 */
public final byte[] getPathTypes() 

$pres = new Presentation("shape.pptx");

$autoShape = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);

$elements = $autoShape->createShapeElements();
for ($e = 0; $e < count(java_values($elements)); $e++) {
    echo "Start element\n";
    $element = $elements[$e];

    $types = $element->getPathTypes();
    $points = $element->getPathPoints();

    for ($i = 0; $i < count(java_values($points)); $i++) {
        switch (java_values($types[$i]) & 0xFF) {
            case 0:
                echo "Start point " . $points[$i] . "\n";
                break;
            case 1:
                echo "LineTo point " . $points[$i] . "\n";
                break;
            case 3:
                echo "Bezier spline point " . $points[$i] . "\n";
                break;
            case 128:
                echo "Close subpath point " . $points[$i] . "\n";
                break;
            case 129:
                echo "End point " . $points[$i] . "\n";
                break;
        }
    }
}

$pres->dispose();

/**
 * <p>
 * Represents the assignment method for the sensitivity label.
 * </p>
 */
public final class SensitivityLabelAssignmentType
{
    /**
     * <p>
     * Use for any sensitivity label that was not directly applied by the user. 
     * This includes any default labels, automatically applied labels.
     * </p>
     */
    public static final int Standard = 0;
    /**
     * <p>
     * Use for any sensitivity label that was directly applied by the user. 
     * This includes any manually applied sensitivity labels as well as recommended
     * or mandatory labeling or any feature where the user decides which sensitivity label to apply.
     * </p>
     */
    public static final int Privileged = 1;

}

/**
 * <p>
 * Represents the types of content marking that ought to be applied to a document.
 * </p>
 */
public final class SensitivityLabelContentType
{
    /**
     * <p>
     * Implies that the label is applied by default or automatically.
     * </p>
     */
    public static final int None = 0;
    /**
     * <p>
     * Implies that the label was manually applied.
     * Use for any sensitivity label that was directly applied by the user.
     * </p>
     */
    public static final int Header = 1;
    /**
     * <p>
     * Implies that the label was manually applied.
     * Use for any sensitivity label that was directly applied by the user.
     * </p>
     */
    public static final int Footer = 2;
    /**
     * <p>
     * Implies that the label was manually applied.
     * Use for any sensitivity label that was directly applied by the user.
     * </p>
     */
    public static final int Watermark = 4;
    /**
     * <p>
     * Implies that the label was manually applied.
     * Use for any sensitivity label that was directly applied by the user.
     * </p>
     */
    public static final int Encryption = 8;
}

/**
 * <p>
 * Represents the sensitivity label from Microsoft Purview Information Protection.
 * </p>
 */
public interface ISensitivityLabel
{
    /**
     * <p>
     * Returns or sets the id of sensitivity label.
     * Read/write {@link String}.
     * </p>
     */
    public String getId();
    
    /**
     * <p>
     * Returns or sets the id of sensitivity label.
     * Read/write {@link String}.
     * </p>
     */
    public void setId(String value);

    /**
     * <p>
     * Returns or sets the Azure Active Directory (Azure AD) site identifier 
     * corresponding to the sensitivity label policy which describes the sensitivity label.
     * Read/write {@link java.util.UUID}.
     * </p>
     */
    public java.util.UUID getSiteId();

    /**
     * <p>
     * Returns or sets the Azure Active Directory (Azure AD) site identifier 
     * corresponding to the sensitivity label policy which describes the sensitivity label.
     * Read/write {@link java.util.UUID}.
     * </p>
     */
    public void setSiteId(java.util.UUID value);

    /**
     * <p>
     * Indicates whether the sensitivity label is enabled.
     * </p>
     */
    public boolean isEnabled();
    
    /**
     * <p>
     * Indicates whether the sensitivity label is enabled.
     * </p>
     */
    public void setEnabled(boolean value);

    /**
     * <p>
     * Indicates whether the sensitivity label was removed.
     * </p>
     */
    public boolean isRemoved();
    
    /**
     * <p>
     * Indicates whether the sensitivity label was removed.
     * </p>
     */
    public void setRemoved(boolean value);

    /**
     * <p>
     * Returns or sets the assignment method for the sensitivity label.
     * Read/write {@link SensitivityLabelAssignmentType}.
     * </p>
     */
    public int getAssignmentMethodType();
    
    /**
     * <p>
     * Returns or sets the assignment method for the sensitivity label.
     * Read/write {@link SensitivityLabelAssignmentType}.
     * </p>
     */
    public void setAssignmentMethodType(int value);

    /**
     * <p>
     * Returns the list of types of content marking that ought to be applied to a file.
     * </p>
     * @return A list of content types {@link SensitivityLabelContentType}
     */
    public IGenericList<Integer> getContentMarkTypes();
}

/**
 * <p>
 * Represents a collection of sensitivity labels applied to the document.
 * </p>
 */
public interface ISensitivityLabelCollection
{
    /**
     * <p>
     * Returns the sensitivity label by index.
     * Read-only {@link ISensitivityLabel}.
     * </p>
     */
    public ISensitivityLabel get_Item(int index);

    /**
     * <p>
     * Adds the sensitivity label at the end of the collection.
     * </p>
     * @param id The id of sensitivity label.
     * @param siteId The Azure Active Directory (Azure AD) site identifier.
     * @param isEnabled Flag indicates whether the sensitivity label is enabled.
     * @param methodType The assignment method for the sensitivity label.
     */
    public ISensitivityLabel add(String id, java.util.UUID siteId, boolean isEnabled, int methodType);

    /**
     * <p>
     * Adds a SensitivityLabel to the collection.
     * </p>
     * @return The index at which the SensitivityLabel was added.
     * @exception ArgumentException 
     * Thrown when the sensitivity label with the same Id has already been added.
     * @param label The SensitivityLabel object to be added at the end of the collection.
     */
    public int add(ISensitivityLabel label);

    /**
     * <p>
     * Removes the sensitivity label at the specified index.
     * </p>
     * @param index Index of the sensitivity label that should be deleted.
     */
    public void removeAt(int index);

    /**
     * <p>
     * Removes all elements from the collection.
     * </p>
     */
    public void clear();

    /**
     * <p>
     * Gets the number of all elements in the collection.
     * Read-only {@code int}.
     * </p>
     */
    public int getCount();
}

/**
 * <p>
 * Returns the collection of sensitivity labels applied to the presentation document.
 * Read-only {@link ISensitivityLabelCollection}.
 * </p>
 */
public final ISensitivityLabelCollection getSensitivityLabels()

$pres = new Presentation("SomePresentation.pptx");

$sensitivityLabels = $pres->getSensitivityLabels();

for ($i = 0; $i < java_values($sensitivityLabels->getCount()); $i++) {
    echo "Label Id " . $sensitivityLabels->get_Item($i)->getId() .
         " from Azure AD site " . $sensitivityLabels->get_Item($i)->getSiteId() . "\n";
}

$pres->dispose();

$pres = new Presentation("SomePresentation.pptx");

$sensitivityLabels = $pres->getSensitivityLabels();

// Add the new label
$labelIdString = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"; // Get the sensitivity label Id from the policy
$siteIdGuid = java("java.util.UUID")->fromString("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"); // Get the Azure AD site identifier from the policy
$label = $sensitivityLabels->add($labelIdString, $siteIdGuid, true, SensitivityLabelAssignmentType::Privileged);
$label->getContentMarkTypes()->addItem(SensitivityLabelContentType::Footer);

$pres->save("SensitivityLabel.pptx", SaveFormat::Pptx);

$pres->dispose();

/**
 * <p>
 * Gets an array of sensitivity labels from the custom document properties (Microsoft Information Protection SDK Metadata).
 * </p>
 */
public final ISensitivityLabel[] getSensitivityLabels()

$pres = new Presentation("SomePresentation.pptx");

// Get sensitivity labels from the custom document properties
$mipSensitivityLabels = $pres->getDocumentProperties()->getSensitivityLabels();

$sensitivityLabels = $pres->getSensitivityLabels();
for ($i = 0; $i < count(java_values($mipSensitivityLabels)); $i++) {
    // Add label to the collection
    // Here you can add a check for the validity of the label information (the label is available, etc)
    $sensitivityLabels->add($mipSensitivityLabels[$i]);
}

$pres->save("SensitivityLabel.pptx", SaveFormat::Pptx);

$pres->dispose();