Aspose.Slides for PHP via Java 24.12 Release Notes

$type = EffectType::Descend;
echo $type == EffectType::Descend; // Should return 'true'
echo $type == EffectType::FloatDown; // Should return 'true'

$type = EffectType::FloatDown;
echo $type == EffectType::Descend; // Should return 'true'
echo $type == EffectType::FloatDown; // Should return 'true'

$type = EffectType::Ascend;
echo $type == EffectType::Ascend; // Should return 'true'
echo $type == EffectType::FloatUp; // Should return 'true'

$type = EffectType::FloatUp;
echo $type == EffectType::Ascend; // Should return 'true'
echo $type == EffectType::FloatUp; // Should return 'true'

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

$slide = $presentation->getSlides()->get_Item(0);

// Get the PictureFrame from the slide
$picFrame = $slide->getShapes()->get_Item(0);

// Compress the image with a target resolution of 150 DPI (Web resolution) and remove cropped areas
$result = $picFrame->getPictureFormat()->compressImage(true, 150);

// Check the result of the compression
if (java_values($result))
{
    echo "Image successfully compressed.";
}
else
{
    echo "Image compression failed or no changes were necessary.";
}

$presentation->dispose();

$presentationText = PresentationFactory::getInstance()->getPresentationText("Presentation.pptx", TextExtractionArrangingMode::Unarranged);

$slideText = java_values($presentationText->getSlidesText());
for ($i = 0 ; $i < count($slideText); $i++)
{
    $slideNumber = $i + 1;
    $commentText = $slideText[$i]->getCommentsText();
    echo "Comments for slide " . $slideNumber . " : " . $commentText  . "\n";
}

/**
 * <p>
 * Returns or sets the grid spacing that should be used for the grid underlying the presentation document, in points. 
 * Read/write float.
 * </p>
 * <pre> 
 * $pres = new Presentation();
 * $pres->getViewProperties()->setGridSpacing(72);
 * $pres->save("GridSpacing_out.pptx", SaveFormat::Pptx);
 * $pres->dispose();
 * </pre>
 * The grid spacing value must be a positive number.
 * The typical value range is from 1 mm (2.8349607 points) to 2 inches (144 points).
 */
float getGridSpacing();

/**
 * <p>
 * Represents an adjustable drawing guide.
 * </p>
 */
public interface IDrawingGuide
{
    /**
     * <p>
     * Returns or sets orientation of the drawing guide.
     * Read/write Orientation.
     * </p>
     */
    byte getOrientation();
    void setOrientation(byte value);

    /**
     * <p>
     * Returns or sets position of the drawing guide in points from the top, left corner of the slide.
     * Read/write float.
     * </p>
     * <p>
     * The typical value range is from zero to slide height for a horizontal guide and from zero to slide width for a vertical guide.
     * </p>
     */
    float getPosition();
    void setPosition(float value);
}

/**
 * <p>
 * Represents a collection of the adjustable drawing guides.
 * </p>
 */
public interface IDrawingGuidesCollection extends IGenericEnumerable<IDrawingGuide>
{
    /**
     * <p>
     * Returns the drawing guide by index.
     * Read-only IDrawingGuide.
     * </p>
     */
    IDrawingGuide get_Item(int index);

    /**
     * <p>
     * Adds the drawing guide at the end of the collection.
     * </p>
     * @param orientation Orientation of the drawing guide.
     * @param position Position of the the drawing guide in points.
     */
    IDrawingGuide add(byte orientation, float position);

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

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

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

/**
 * <p>
 * Returns the collection of the drawing guides.
 * Read-only DrawingGuidesCollection
 * </p>
 * The following sample code shows how to add the new drawing guides in a PowerPoint presentation.
 * <pre>
 * $pres = new Presentation();
 * $slideSize = $pres->getSlideSize()->getSize();
 * $guides = $pres->getViewProperties()->getSlideViewProperties()->getDrawingGuides();
 * // Adding the new vertical drawing guide to the right of the slide center
 * $guides->add(Orientation::Vertical, (java_values($slideSize->getWidth()) / 2) + 12.5);
 * // Adding the new horizontal drawing guide below the slide center
 * $guides->add(Orientation::Horizontal, (java_values($slideSize->getHeight()) / 2) + 12.5);
 * $pres->save("DrawingGuides_out.pptx", SaveFormat::Pptx);
 * $pres->dispose();
 * </pre>
 */
public DrawingGuidesCollection getDrawingGuides();

$pres = new Presentation();

$pres->getViewProperties()->setGridSpacing(72);
$pres->save("GridSpacing_out.pptx", SaveFormat::Pptx);

$pres->dispose();

$pres = new Presentation();

$slideSize = $pres->getSlideSize()->getSize();
$guides = $pres->getViewProperties()->getSlideViewProperties()->getDrawingGuides();
// Adding the new vertical drawing guide to the right of the slide center
$guides->add(Orientation::Vertical, (java_values($slideSize->getWidth()) / 2) + 12.5);
// Adding the new horizontal drawing guide below the slide center
$guides->add(Orientation::Horizontal, (java_values($slideSize->getHeight()) / 2) + 12.5);

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

$pres->dispose();

$presentation = new Presentation("pres.pptx");
$effect = $presentation->getSlides()->get_Item(0)->getTimeline()->getMainSequence()->get_Item(0);
if (java_values($effect->getType()) == EffectType::FadedZoom)
{
    echo $effect->getType() . " - " . $effect->getSubtype();
}
$presentation->dispose();