Lettertypen insluiten in presentaties op Android

Waar deze pagina over gaat

Beheer ingesloten lettertypen in PowerPoint met Aspose.Slides for Android via Java. Voeg toe, haal op, verwijder en comprimeer lettertypen om de weergave van tekst te behouden en de bestandsgrootte te verkleinen.

Inleiding

Ingebedde lettertypen slaan lettertype‑gegevens op binnen een PowerPoint‑presentatie. Wanneer een viewer ingebedde lettertypen ondersteunt, kan hij de tekst weergeven met die lettertypen, zelfs als ze niet op het doelsysteem zijn geïnstalleerd. Dit helpt om regeleinden, tekstruimtes en de lay‑out van de dia te behouden.

Aspose.Slides for Android via Java stelt u in staat om ingebedde lettertypen op te halen, toe te voegen en te verwijderen via de IFontsManager interface die wordt geretourneerd door Presentation.getFontsManager. U kunt ook de omvang van ingebedde lettertype‑gegevens verkleinen door tekens te verwijderen die de presentatie niet gebruikt.

De voorbeelden hieronder werken met PPTX‑bestanden. Zorg ervoor dat de lettertype‑gegevens beschikbaar zijn voor Aspose.Slides en dat de licentie het insluiten toestaat, voordat u een lettertype insluit.

Ingebedde lettertypen ophalen en verwijderen

Gebruik getEmbeddedFonts om de lettertypen die in een presentatie zijn opgeslagen op te sommen. Om er één te verwijderen, geeft u een lettertype uit die lijst door aan removeEmbeddedFont, en slaat u vervolgens de presentatie op.

Het volgende voorbeeld somt de ingebedde lettertypen in EmbeddedFonts.pptx op en verwijdert Calibri indien aanwezig:

import com.aspose.slides.IFontData;
import com.aspose.slides.IFontsManager;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("EmbeddedFonts.pptx");
try {
    IFontsManager fontsManager = presentation.getFontsManager();
    IFontData[] embeddedFonts = fontsManager.getEmbeddedFonts();

    for (IFontData font : embeddedFonts) {
        System.out.println(font.getFontName());
    }

    IFontData fontToRemove = null;
    for (IFontData font : embeddedFonts) {
        if ("Calibri".equalsIgnoreCase(font.getFontName())) {
            fontToRemove = font;
            break;
        }
    }

    if (fontToRemove != null) {
        fontsManager.removeEmbeddedFont(fontToRemove);
        presentation.save("WithoutEmbeddedCalibri.pptx", SaveFormat.Pptx);
    } else {
        System.out.println("Calibri is not embedded. No output file was created.");
    }
} finally {
    presentation.dispose();
}

Het verwijderen van een ingebed lettertype verwijdert de opgeslagen lettertype‑gegevens; het verandert niet het aan de tekst toegewezen lettertype. Als het lettertype op het doelsysteem is geïnstalleerd, kan de tekst het nog steeds gebruiken. Anders kan rendering een lettertypevervanging vereisen, wat de lay‑out kan beïnvloeden.

Lettertype‑gegevens en insluitingsrechten inspecteren

Gebruik de IFontsManager interface om lettertypen te inspecteren voordat u ze insluit. Roep IFontsManager.getFonts aan om de in de presentatie gebruikte lettertypen op te halen. Voor elk lettertype geeft u een IFontData object en de benodigde FontStyleType waarde door aan IFontsManager.getFontBytes. De methode retourneert de binaire gegevens voor die lettertype‑stijl, of null wanneer het gevraagde lettertype of de stijl niet beschikbaar is. Geef geen null resultaat door aan IFontsManager.getFontEmbeddingLevel, omdat die methode een byte‑array vereist.

EmbeddingLevel is een flags‑enumeratie die de insluitingsbeperkingen in het lettertype meldt:

Installable staat insluiten en permanente installatie op een ander systeem toe, onder voorbehoud van de licentie van het lettertype.
Restricted verbiedt insluiten tenzij toestemming wordt verkregen van de rechts eigenaar van het lettertype wanneer dit de enige permissie‑flag is.
PreviewPrint staat tijdelijk gebruik voor weergave en afdrukken toe; een document dat het lettertype bevat moet alleen‑lezen zijn.
Editable staat tijdelijk gebruik toe en maakt het mogelijk het document te bewerken en op te slaan.
NoSubsetting is een extra beperking die verbiedt alleen een subset van de tekens in te sluiten. Sluit alle tekens in wanneer deze flag aanwezig is.
BitmapOnly is een extra beperking die alleen bitmap‑strikes toestaat om in te sluiten, geen contourgegevens. Als het lettertype geen bitmap‑strikes heeft, kan het niet worden ingesloten.

De eerste vier waarden beschrijven de gebruikstoestemming, terwijl NoSubsetting en BitmapOnly hiermee gecombineerd kunnen worden. Controleer de modifiers met bitwise‑operaties. Omdat Installable nul is, maskert u de gebruikstoestemmingsbits en vergelijkt u het resultaat met Installable in plaats van het als een aparte flag te controleren. Huidige lettertypen mogen hoogstens één gebruikstoestemmingsbit hebben. Voor compatibiliteit met oudere lettertypen die meer dan één bit zetten, selecteert de onderstaande helper de minst beperkende toestemming: Editable, dan PreviewPrint, dan Restricted.

Het volgende voorbeeld controleert de reguliere, vet, cursief en vet‑cursief gegevens die beschikbaar zijn voor elk lettertype dat door getFonts wordt geretourneerd. Het slaat onbeschikbare stijlen, beperkte lettertypen, alleen‑bitmap lettertypen, lettertypen die beperkt zijn tot preview en print omdat de output bewerkbaar blijft, en al ingesloten lettertypen over. Als een beschikbare stijl NoSubsetting heeft, wordt voor die lettertypefamilie elke teken ingesloten.

import com.aspose.slides.EmbedFontCharacters;
import com.aspose.slides.EmbeddingLevel;
import com.aspose.slides.FontStyleType;
import com.aspose.slides.IFontData;
import com.aspose.slides.IFontsManager;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Locale;
import java.util.Set;

class EmbeddingPermission {
    int getUsagePermission(int level) {
        int permissionMask = EmbeddingLevel.Restricted | EmbeddingLevel.PreviewPrint | EmbeddingLevel.Editable;
        int permissions = level & permissionMask;

        if ((permissions & EmbeddingLevel.Editable) != 0) {
            return EmbeddingLevel.Editable;
        }

        if ((permissions & EmbeddingLevel.PreviewPrint) != 0) {
            return EmbeddingLevel.PreviewPrint;
        }

        if ((permissions & EmbeddingLevel.Restricted) != 0) {
            return EmbeddingLevel.Restricted;
        }

        return EmbeddingLevel.Installable;
    }
}

Presentation presentation = new Presentation("Fonts.pptx");
try {
    IFontsManager fontsManager = presentation.getFontsManager();
    int[] fontStyles = {
        FontStyleType.Regular,
        FontStyleType.Bold,
        FontStyleType.Italic,
        FontStyleType.Bold | FontStyleType.Italic
    };

    Set<String> embeddedFontNames = new HashSet<String>();
    for (IFontData embeddedFont : fontsManager.getEmbeddedFonts()) {
        embeddedFontNames.add(embeddedFont.getFontName().toLowerCase(Locale.ROOT));
    }

    EmbeddingPermission permissionHelper = new EmbeddingPermission();
    List<IFontData> fontsToEmbed = new ArrayList<IFontData>();
    List<Integer> embeddingRules = new ArrayList<Integer>();
    for (IFontData font : fontsManager.getFonts()) {
        if (embeddedFontNames.contains(font.getFontName().toLowerCase(Locale.ROOT))) {
            System.out.println(font.getFontName() + ": already embedded.");
            continue;
        }

        boolean hasAvailableData = false;
        boolean allAvailableStylesCanBeEmbedded = true;
        boolean previewPrintOnly = false;
        boolean requiresFullFont = false;

        for (int fontStyle : fontStyles) {
            byte[] fontBytes = fontsManager.getFontBytes(font, fontStyle);
            if (fontBytes == null) {
                System.out.println(font.getFontName() + " (" + fontStyle + "): font data is unavailable.");
                continue;
            }

            hasAvailableData = true;
            int embeddingLevel = fontsManager.getFontEmbeddingLevel(fontBytes, font.getFontName());
            int usagePermission = permissionHelper.getUsagePermission(embeddingLevel);
            boolean noSubsetting = (embeddingLevel & EmbeddingLevel.NoSubsetting) != 0;
            boolean bitmapOnly = (embeddingLevel & EmbeddingLevel.BitmapOnly) != 0;

            requiresFullFont |= noSubsetting;
            previewPrintOnly |= usagePermission == EmbeddingLevel.PreviewPrint;
            allAvailableStylesCanBeEmbedded &= usagePermission != EmbeddingLevel.Restricted && !bitmapOnly;

            System.out.println(font.getFontName() + " (" + fontStyle + "): " + embeddingLevel + ".");
        }

        if (!hasAvailableData) {
            System.out.println(font.getFontName() + ": skipped because no requested style is available.");
        } else if (!allAvailableStylesCanBeEmbedded) {
            System.out.println(font.getFontName() + ": skipped because at least one available style does not permit outline embedding.");
        } else if (previewPrintOnly) {
            System.out.println(font.getFontName() + ": skipped because this example produces an editable presentation.");
        } else {
            int rule = requiresFullFont ? EmbedFontCharacters.All : EmbedFontCharacters.OnlyUsed;
            fontsToEmbed.add(font);
            embeddingRules.add(rule);
        }
    }

    for (int i = 0; i < fontsToEmbed.size(); i++) {
        fontsManager.addEmbeddedFont(fontsToEmbed.get(i), embeddingRules.get(i));
    }

    presentation.save("WithAuditedFonts.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Deze inspectie rapporteert de beperkingen die in elk lettertype‑bestand zijn gecodeerd. Het verleent geen licentie, bewijst niet dat u het lettertype legaal hebt verkregen, en vervangt niet het controleren van de licentieovereenkomst van het lettertype voordat u een ingebedde kopie distribueert.

Ingebedde lettertypen toevoegen

Gebruik addEmbeddedFont om een lettertype in te sluiten. De overloads accepteren ofwel een IFontData object of een byte‑array met de lettertype‑gegevens. De EmbedFontCharacters enumeratie bepaalt welke tekens worden opgenomen:

All sluit alle tekens in het lettertype in. Gebruik deze optie wanneer ontvangers de presentatie moeten kunnen bewerken en nieuwe tekst moeten invoeren.
OnlyUsed sluit alleen de tekens in die in de presentatie worden gebruikt om de bestandsgrootte te verkleinen. Kies deze optie voor een afgewerkte presentatie die voornamelijk bestemd is voor weergave.

Het volgende voorbeeld gebruikt getFonts om de in Fonts.pptx gebruikte lettertypen op te halen en sluit die in die nog niet zijn ingesloten. De toe te voegen lettertypen moeten beschikbaar zijn op het Android‑apparaat of geregistreerd zijn bij Aspose.Slides. Bestaande ingebedde lettertypen behouden hun huidige tekenverzamelingen.

import com.aspose.slides.EmbedFontCharacters;
import com.aspose.slides.IFontData;
import com.aspose.slides.IFontsManager;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import java.util.HashSet;
import java.util.Locale;
import java.util.Set;

Presentation presentation = new Presentation("Fonts.pptx");
try {
    IFontsManager fontsManager = presentation.getFontsManager();
    IFontData[] allFonts = fontsManager.getFonts();
    IFontData[] embeddedFonts = fontsManager.getEmbeddedFonts();
    Set<String> embeddedFontNames = new HashSet<String>();

    for (IFontData embeddedFont : embeddedFonts) {
        embeddedFontNames.add(embeddedFont.getFontName().toLowerCase(Locale.ROOT));
    }

    for (IFontData font : allFonts) {
        String fontName = font.getFontName().toLowerCase(Locale.ROOT);
        if (!embeddedFontNames.contains(fontName)) {
            fontsManager.addEmbeddedFont(font, EmbedFontCharacters.All);
            embeddedFontNames.add(fontName);
        }
    }

    presentation.save("WithEmbeddedFonts.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Ingebedde lettertypen comprimeren

Compress.compressEmbeddedFonts verkleint ingebedde lettertype‑gegevens door ongebruikte tekens te verwijderen. Het werkt op lettertypen die al zijn ingesloten, dus de reductie hangt af van hoeveel ongebruikte lettertype‑gegevens de presentatie bevat.

Het volgende voorbeeld comprimeert de lettertypen in EmbeddedFonts.pptx en slaat het resultaat op als een apart bestand:

import com.aspose.slides.Compress;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("EmbeddedFonts.pptx");
try {
    Compress.compressEmbeddedFonts(presentation);
    presentation.save("CompressedEmbeddedFonts.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Bewaar het originele bestand als ontvangers later tekst willen toevoegen. Tekens die tijdens compressie zijn verwijderd, zijn niet langer beschikbaar vanuit het ingebedde lettertype, zelfs als u oorspronkelijk alle tekens had ingesloten.

FAQ

Hoe kan ik controleren of een ingebed lettertype nog steeds wordt vervangen tijdens het renderen?

Roep getSubstitutions aan in de omgeving waarin u de presentatie rendert om te zien welke lettertypen Aspose.Slides zal vervangen. Controleer ook de instellingen voor lettertypevervanging en de regels voor lettertypefallback. Fallback behandelt ontbrekende tekens, dus het insluiten van een lettertype lost geen tekens op die het lettertype zelf niet bevat.

Moet ik veelgebruikte lettertypen zoals Arial en Calibri insluiten?

Baseer de beslissing op de doelomgeving. Als de benodigde lettertypen op elk apparaat dat de presentatie opent of rendert beschikbaar zijn, kan het insluiten van deze lettertypen onnodige bestandsgrootte toevoegen. Als ontvangers of servers deze lettertypen mogelijk niet hebben, kan insluiten helpen om de beoogde weergave te behouden, mits de licenties dit toestaan.

Standaardlettertypen voor presentaties op Android Beheer fallback-lettertypen voor presentaties op Android