Gestionar temas de presentaciones PowerPoint en Python
Introducción
Un tema de presentación define un conjunto coordinado de colores, fuentes, estilos de fondo, rellenos, líneas y efectos. Los objetos con capacidad de tema hacen referencia a estas definiciones compartidas en lugar de almacenar cada propiedad visual como un valor fijo, de modo que un cambio de tema puede actualizar muchos objetos a la vez.
En Aspose.Slides, el tema a nivel de presentación está disponible a través de la propiedad Presentation.master_theme. Una presentación también puede contener anulaciones de tema en niveles inferiores. Un maestro puede anular el tema de la presentación mediante MasterThemeManager.override_theme, un diseño puede anular su tema heredado mediante BaseOverrideThemeManager.override_theme, y una diapositiva individual puede hacer lo mismo. En la práctica, el tema efectivo para una diapositiva se resuelve a través de esta cadena de herencia: tema de presentación, anulación del maestro, anulación del diseño y anulación de la diapositiva.
Las secciones siguientes muestran los flujos de trabajo de tema más habituales: inspeccionar un tema, cambiar colores y fuentes, copiar o aplicar un tema, actualizar estilos de fondo y efectos, y leer los valores efectivos después de que se hayan resuelto la herencia y las anulaciones.
Inspeccionar un Tema
El objeto MasterTheme expone las propiedades color_scheme, font_scheme y format_scheme del tema. Inspeccionar estas colecciones antes de modificarlas es especialmente útil cuando una presentación proviene de una fuente externa, ya que el número y el contenido de las entradas de estilo pueden variar.
El siguiente ejemplo lee las propiedades principales del tema e informa cuántos estilos de fondo, relleno, línea y efecto están almacenados en el tema:
import aspose.slides as slides
with slides.Presentation("input.pptx") as presentation:
theme = presentation.master_theme
print(f"Theme name: {theme.name}")
print(f"Accent 1: {theme.color_scheme.accent1.color}")
print(f"Major Latin font: {theme.font_scheme.major.latin_font.font_name}")
print(f"Minor Latin font: {theme.font_scheme.minor.latin_font.font_name}")
print(f"Background fill styles: {len(theme.format_scheme.background_fill_styles)}")
print(f"Fill styles: {len(theme.format_scheme.fill_styles)}")
print(f"Line styles: {len(theme.format_scheme.line_styles)}")
print(f"Effect styles: {len(theme.format_scheme.effect_styles)}")
Si un archivo utiliza varios maestros, no asumas que cada diapositiva tiene el mismo tema efectivo. Inspecciona el maestro asociado a la diapositiva y utiliza el flujo de trabajo de tema efectivo que se muestra más adelante en este artículo cuando puedan existir anulaciones de diseño o de diapositiva.
Cambiar Colores del Tema
Los rellenos, líneas y textos con capacidad de tema pueden referirse a un color lógico de la enumeración SchemeColor. Cuando cambias la entrada correspondiente en el ColorScheme del tema, todos los objetos que aún hacen referencia a ese color de tema se resuelven con el nuevo valor. Los objetos que utilizan un color RGB directo no se modifican con una actualización de color de tema.
El siguiente ejemplo completo crea una forma que usa ACCENT4, cambia el color accent4 del tema a rojo, guarda la presentación, la vuelve a abrir y muestra el color de relleno efectivo:
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 100, 100)
shape.fill_format.fill_type = slides.FillType.SOLID
shape.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
presentation.master_theme.color_scheme.accent4.color = draw.Color.red
presentation.save("theme-color.pptx", slides.export.SaveFormat.PPTX)
with slides.Presentation("theme-color.pptx") as saved_presentation:
saved_slide = saved_presentation.slides[0]
saved_shape = saved_slide.shapes[0]
effective_fill = saved_shape.fill_format.get_effective()
print(f"Effective fill color: {effective_fill.solid_fill_color}")
Como el rectángulo sigue enlazado a ACCENT4, su color visible pasa a rojo después de cambiar el tema. Si sustituyes el color de esquema por un color directo en la forma, los cambios posteriores de accent4 ya no afectarán a ese relleno.
Usar colores de la paleta adicional
PowerPoint genera variantes más claras y más oscuras a partir de un color de tema aplicando transformaciones de color. Aspose.Slides expone estas transformaciones mediante la enumeración ColorTransformOperation.
1 – Colores principales del tema.
2 – Variantes más claras y más oscuras producidas a partir de los colores principales del tema.
El siguiente ejemplo crea seis rectángulos basados en ACCENT4, aplica transformaciones de luminancia a cinco de ellos y guarda el resultado:
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape1 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 50, 50)
shape1.fill_format.fill_type = slides.FillType.SOLID
shape1.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
shape2 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 70, 50, 50)
shape2.fill_format.fill_type = slides.FillType.SOLID
shape2.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
shape2.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.2)
shape2.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.ADD_LUMINANCE, 0.8)
shape3 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 130, 50, 50)
shape3.fill_format.fill_type = slides.FillType.SOLID
shape3.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
shape3.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.4)
shape3.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.ADD_LUMINANCE, 0.6)
shape4 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 190, 50, 50)
shape4.fill_format.fill_type = slides.FillType.SOLID
shape4.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
shape4.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.6)
shape4.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.ADD_LUMINANCE, 0.4)
shape5 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 250, 50, 50)
shape5.fill_format.fill_type = slides.FillType.SOLID
shape5.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
shape5.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.75)
shape6 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 310, 50, 50)
shape6.fill_format.fill_type = slides.FillType.SOLID
shape6.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
shape6.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.5)
presentation.save("theme-color-palette.pptx", slides.export.SaveFormat.PPTX)
Estas variantes siguen basadas en el color de tema. Si accent4 cambia más adelante, los colores transformados se recalculan a partir del nuevo valor de accent4.
Mapear valores de SchemeColor a ranuras de ColorScheme
La enumeración SchemeColor utiliza TEXT1, BACKGROUND1, TEXT2 y BACKGROUND2, mientras que ColorScheme expone las mismas ranuras del tema como dark1, light1, dark2 y light2. El mapeo es fijo:
TEXT1=dark1BACKGROUND1=light1TEXT2=dark2BACKGROUND2=light2
Estos son nombres alternativos para las mismas ranuras del tema; no son valores que se conviertan dinámicamente de una forma a otra.
Cambiar Fuentes del Tema
Un esquema de fuentes del tema contiene un conjunto principal de fuentes para encabezados y un conjunto secundario para el cuerpo del texto. Las propiedades FontScheme.major y FontScheme.minor exponen esos conjuntos.
Los identificadores de fuentes de tema compatibles con PowerPoint pueden usarse en el formato de texto:
+mn-lt– Fuente del cuerpo Latin (Minor Latin Font)+mj-lt– Fuente del encabezado Latin (Major Latin Font)+mn-ea– Fuente del cuerpo East Asian (Minor East Asian Font)+mj-ea– Fuente del encabezado East Asian (Major East Asian Font)
El siguiente ejemplo crea un encabezado que usa la fuente latina mayor del tema y una línea de cuerpo que usa la fuente latina menor del tema. A continuación cambia las fuentes del tema y guarda el resultado:
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
heading = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 40, 40, 500, 60)
heading.text_frame.text = "Theme heading"
heading.text_frame.paragraphs[0].portions[0].portion_format.latin_font = slides.FontData("+mj-lt")
body = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 40, 120, 500, 60)
body.text_frame.text = "Theme body text"
body.text_frame.paragraphs[0].portions[0].portion_format.latin_font = slides.FontData("+mn-lt")
presentation.master_theme.font_scheme.major.latin_font = slides.FontData("Aptos Display")
presentation.master_theme.font_scheme.minor.latin_font = slides.FontData("Arial")
presentation.save("theme-fonts.pptx", slides.export.SaveFormat.PPTX)
El encabezado sigue la fuente mayor y el texto del cuerpo sigue la fuente menor. El texto que tiene un nombre de fuente explícito en lugar de un identificador de tema no cambiará automáticamente cuando el esquema de fuentes del tema cambie.
Las colecciones mayor y menor también pueden contener asignaciones de fuentes para sistemas de escritura individuales, como cirílico, árabe, japonés, georgiano y thaana. Para inspeccionar, añadir, reemplazar o eliminar estas asignaciones, consulta Script-Specific Theme Fonts.
Tip
Para obtener más información sobre las fuentes de presentación, consulta PowerPoint Fonts.Copiar o Aplicar un Tema
Los flujos de trabajo siguientes resuelven diferentes problemas relacionados con los temas.
Aplicar un Tema externo a las diapositivas dependientes de un Maestro
Utiliza IMasterSlide.apply_external_theme_to_depending_slides cuando dispones de un archivo de tema de PowerPoint (.thmx) y deseas volver a estilizar todas las diapositivas que dependen de un maestro concreto. Selecciona el maestro de la colección Presentation.masters, que implementa MasterSlideCollection, y pasa la ruta al archivo de tema al método.
El método realiza las siguientes operaciones:
- Crea una nueva diapositiva maestra basada en el maestro seleccionado.
- Aplica el tema externo a la nueva maestra.
- Asigna la nueva maestra a todas las diapositivas que antes dependían del maestro seleccionado.
- Devuelve el nuevo IMasterSlide.
El siguiente ejemplo aplica un tema externo a las diapositivas que dependen del primer maestro y guarda la presentación:
import aspose.slides as slides
with slides.Presentation("presentation.pptx") as presentation:
selected_master = presentation.masters[0]
themed_master = selected_master.apply_external_theme_to_depending_slides("corporate-theme.thmx")
print(f"Created master: {themed_master.name}")
presentation.save("presentation-with-external-theme.pptx", slides.export.SaveFormat.PPTX)
Un tema no válido, corrupto o no compatible puede provocar una PptxException o una de sus subclases relacionadas con el formato. Valida las rutas suministradas por los usuarios, maneja los fallos de acceso al sistema de archivos y guarda la presentación solo después de que el tema se haya aplicado con éxito.
Solo se reasignan las diapositivas que dependían del maestro seleccionado. Las diapositivas asociadas a otros maestros conservan sus maestros y temas existentes. Los colores, fuentes, rellenos, líneas, fondos y efectos con capacidad de tema se resuelven con respecto al tema externo. Los colores, fuentes, rellenos y demás formato asignado directamente pueden permanecer sin cambios. Las anulaciones a nivel de diseño y de diapositiva también pueden tener prioridad sobre los valores heredados del nuevo maestro.
El tema puede hacer referencia a fuentes que no están disponibles en el entorno de ejecución. Para un renderizado y exportación consistentes, instala las fuentes necesarias, proporciónalas mediante fuentes personalizadas, o configura la sustitución de fuentes.
Este es un flujo de trabajo directo a nivel de maestro: el método acepta la ruta a un archivo .thmx y no requiere crear manualmente anulaciones de tema a nivel de diapositiva o de diseño.
Aplicar diferentes temas externos en una presentación con varios maestros
Cuando el maestro relevante no se conoce de antemano, obténlo a partir de una diapositiva representativa mediante Slide.layout_slide y LayoutSlide.master_slide. Guarda las referencias a los maestros originales antes de aplicar cualquier tema, ya que cada llamada crea otro maestro en la presentación.
El siguiente ejemplo usa diapositivas de dos secciones para localizar sus maestros y aplica un tema externo diferente a cada grupo:
import aspose.slides as slides
with slides.Presentation("multi-master-presentation.pptx") as presentation:
if len(presentation.slides) < 5:
print("The presentation does not contain the expected representative slides.")
else:
first_group_master = presentation.slides[0].layout_slide.master_slide
second_group_master = presentation.slides[4].layout_slide.master_slide
if first_group_master.slide_id == second_group_master.slide_id:
print("The representative slides use the same master.")
else:
first_themed_master = first_group_master.apply_external_theme_to_depending_slides("blue-theme.thmx")
second_themed_master = second_group_master.apply_external_theme_to_depending_slides("green-theme.thmx")
print(f"First themed master: {first_themed_master.name}")
print(f"Second themed master: {second_themed_master.name}")
presentation.save("multi-master-with-external-themes.pptx", slides.export.SaveFormat.PPTX)
La primera llamada afecta solo a las diapositivas que dependían de first_group_master, y la segunda llamada afecta solo a las diapositivas que dependían de second_group_master. Las diapositivas pertenecientes a cualquier otro maestro no se vuelven a estilizar.
Preservar un Tema de Origen al mover diapositivas
Si deseas mover una diapositiva a otra presentación y conservar su diseño original, clona el maestro de origen en la presentación de destino con MasterSlideCollection.add_clone, luego clona la diapositiva con SlideCollection.add_clone y el maestro clonado. Esto lleva el maestro, sus diseños y el tema asociado juntos.
import aspose.slides as slides
with slides.Presentation("source-theme.pptx") as source:
with slides.Presentation("target.pptx") as target:
source_slide = source.slides[0]
source_master = source_slide.layout_slide.master_slide
cloned_master = target.masters.add_clone(source_master)
target.slides.add_clone(source_slide, cloned_master, True)
target.save("theme-preserved.pptx", slides.export.SaveFormat.PPTX)
Este es el flujo de trabajo preferido cuando la diapositiva de origen debe verse igual en el destino. Simplemente clonar contenido sobre un maestro de destino no relacionado puede cambiar los colores, fuentes, fondos y efectos impulsados por el tema.
Aplicar valores del tema a una diapositiva existente
Si la diapositiva de destino debe permanecer en su maestro y diseño actuales, inicializa una anulación a nivel de diapositiva a partir del tema de origen. Los métodos OverrideTheme.init_color_scheme_from, OverrideTheme.init_font_scheme_from y OverrideTheme.init_format_scheme_from copian los tres componentes principales del tema en la anulación.
import aspose.slides as slides
with slides.Presentation("source-theme.pptx") as source:
with slides.Presentation("target.pptx") as target:
target_slide = target.slides[0]
override_theme = target_slide.theme_manager.override_theme
override_theme.init_color_scheme_from(source.master_theme.color_scheme)
override_theme.init_font_scheme_from(source.master_theme.font_scheme)
override_theme.init_format_scheme_from(source.master_theme.format_scheme)
target.save("theme-applied-to-slide.pptx", slides.export.SaveFormat.PPTX)
Esto cambia el tema usado por esa diapositiva sin modificar el tema heredado por otras diapositivas. Para eliminar la anulación local y volver a los valores heredados, llama a OverrideTheme.clear.
Aplicar una anulación de tema a un diseño
Una anulación a nivel de diseño se aplica a las diapositivas que usan ese diseño, a menos que una diapositiva concreta tenga su propia anulación. Los mismos métodos de inicialización pueden usarse a través del LayoutSlideThemeManager del diseño:
import aspose.slides as slides
with slides.Presentation("source-theme.pptx") as source:
with slides.Presentation("target.pptx") as target:
target_slide = target.slides[0]
override_theme = target_slide.layout_slide.theme_manager.override_theme
override_theme.init_color_scheme_from(source.master_theme.color_scheme)
override_theme.init_font_scheme_from(source.master_theme.font_scheme)
override_theme.init_format_scheme_from(source.master_theme.format_scheme)
target.save("theme-applied-to-layout.pptx", slides.export.SaveFormat.PPTX)
Utiliza un tema a nivel de maestro o presentación cuando muchos diseños y diapositivas deben compartir el mismo diseño base, una anulación de diseño cuando una familia de diseños necesita un estilo diferente y una anulación de diapositiva solo para excepciones reales. Un exceso de anulaciones a nivel de diapositiva dificulta predecir los cambios globales posteriores del tema.
Actualizar estilos de fondo del tema
Los rellenos de fondo del tema se almacenan en FormatScheme.background_fill_styles. PowerPoint puede presentar más opciones de fondo en su interfaz que el número de definiciones de relleno almacenadas físicamente en esta colección, porque la UI puede combinar rellenos de tema con colores de tema y otras referencias de estilo.
Antes de usar un estilo de fondo, inspecciona la colección almacenada y el actual Background.style_index. style_index usa 0 para indicar que no hay relleno tematizado; los valores positivos son referencias a estilos de fondo del tema. Esto difiere del índice de una colección de Python, donde [0] significa el primer elemento almacenado. No asumas que todas las presentaciones contienen el mismo número de estilos de relleno de fondo.
El siguiente ejemplo informa el número de rellenos de fondo disponibles, asigna una referencia de fondo tematizado al primer maestro y guarda la presentación:
import aspose.slides as slides
with slides.Presentation("input.pptx") as presentation:
background_styles = presentation.master_theme.format_scheme.background_fill_styles
print(f"Background fill styles: {len(background_styles)}")
if len(background_styles) == 0:
raise RuntimeError("The presentation theme does not contain background fill styles.")
master_slide = presentation.masters[0]
master_slide.background.type = slides.BackgroundType.THEMED
master_slide.background.style_index = 1
presentation.save("theme-background.pptx", slides.export.SaveFormat.PPTX)
El resultado visible depende de la entrada del tema referenciada por el maestro y de cualquier anulación de fondo a nivel de diseño o diapositiva. Si una diapositiva usa su propio fondo, cambiar solo el fondo del maestro puede no afectar a esa diapositiva. Usa Background.get_effective cuando necesites conocer el fondo final después de aplicar la herencia.
Warning
No tratesstyle_index como un índice de colección basado en cero. Además, evita codificar un número de estilo de un archivo y suponer que tiene la misma apariencia en otro archivo; las definiciones de estilo del tema son específicas de cada presentación.
Tip
Para formato directo de fondos y herencia de fondos, consulta Presentation Background.Actualizar efectos del tema
Un esquema de formato del tema contiene colecciones separadas de FormatScheme.fill_styles, FormatScheme.line_styles y FormatScheme.effect_styles. Los temas típicos de Office suelen contener tres entradas principales que corresponden visualmente a formatos sutil, moderado e intenso, pero el código debe inspeccionar cada colección en lugar de suponer un recuento fijo.
Al acceder a estas colecciones en Python, el índice de la colección comienza en cero: [0] es el primer estilo almacenado y [2] el tercero. Los índices de referencia de estilo de una forma son un concepto separado, expuesto mediante IShapeStyle. Modificar un estilo del tema afecta a las formas que hacen referencia a ese estilo; las formas con formato directo pueden permanecer sin cambios.
El siguiente ejemplo verifica que existan las entradas de estilo requeridas, cambia el primer estilo de línea, cambia el tercer estilo de relleno, habilita una sombra externa en el tercer estilo de efecto y guarda el resultado:
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation("Subtle_Moderate_Intense.pptx") as presentation:
format_scheme = presentation.master_theme.format_scheme
if len(format_scheme.line_styles) < 1 or len(format_scheme.fill_styles) < 3 or len(format_scheme.effect_styles) < 3:
raise RuntimeError("The theme does not contain the style entries required by this example.")
format_scheme.line_styles[0].fill_format.fill_type = slides.FillType.SOLID
format_scheme.line_styles[0].fill_format.solid_fill_color.color = draw.Color.red
format_scheme.fill_styles[2].fill_type = slides.FillType.SOLID
format_scheme.fill_styles[2].solid_fill_color.color = draw.Color.forest_green
format_scheme.effect_styles[2].effect_format.enable_outer_shadow_effect()
format_scheme.effect_styles[2].effect_format.outer_shadow_effect.distance = 10
presentation.save("theme-effects.pptx", slides.export.SaveFormat.PPTX)
Para las formas que referencian estas ranuras, el primer estilo de línea del tema pasa a rojo, el tercer estilo de relleno del tema pasa a verde bosque sólido y el tercer estilo de efecto adquiere una sombra externa con una distancia de 10 puntos. El resultado visual exacto sigue dependiendo de qué ranuras de estilo referencie cada forma y de si el formato directo anula el tema.
Determinar si un relleno sólido efectivo usa un color del tema
Un relleno puede almacenarse directamente en un objeto o heredarse de un párrafo, diseño, maestro, estilo de tema u otro nivel de formato. Llama a FillFormat.get_effective para resolver esa jerarquía en un IFillFormatEffectiveData inmutable. Primero verifica IFillFormatEffectiveData.fill_type. Solo cuando sea FillType.SOLID deberías leer las propiedades del relleno sólido.
Para un relleno sólido, IFillFormatEffectiveData.solid_fill_color devuelve el valor RGB final renderizado después de aplicar la herencia, la búsqueda en el tema y las transformaciones de color. IFillFormatEffectiveData.solid_fill_scheme_color devuelve la ranura lógica correspondiente de SchemeColor, como TEXT1 o ACCENT6. Un valor de SchemeColor.NOT_DEFINED indica que el relleno sólido efectivo no se basa en un color de esquema. En un flujo de trabajo donde los rellenos son colores de tema o colores RGB directos, este valor identifica un relleno RGB directo.
No uses únicamente el valor local de IColorFormat.scheme_color para clasificar un relleno. Por ejemplo, una porción de texto puede no tener un color de esquema definido localmente, por lo que su valor local es NOT_DEFINED, mientras que su relleno efectivo hereda un color de tema y se resuelve a TEXT1 o ACCENT6. Por el contrario, solid_fill_scheme_color te indica qué ranura lógica del tema produjo el color efectivo, pero no te dice si esa ranura provino del objeto, párrafo, diseño, maestro u otro nivel de la jerarquía de formato.
El siguiente ejemplo carga una presentación, audita tanto los rellenos de forma como los rellenos de porciones de texto, muestra cada valor RGB final y su color de esquema asociado, y marca los rellenos sólidos que no seguirán los cambios de color del tema:
import aspose.slides as slides
def audit_fill(object_name, local_fill):
effective_fill = local_fill.get_effective()
if effective_fill.fill_type != slides.FillType.SOLID:
print(f"{object_name}: fill type = {effective_fill.fill_type}; not a solid fill.")
return
rgb = effective_fill.solid_fill_color
effective_scheme_color = effective_fill.solid_fill_scheme_color
local_scheme_color = local_fill.solid_fill_color.scheme_color
print(f"{object_name}: RGB = #{rgb.r:02X}{rgb.g:02X}{rgb.b:02X}")
print(f"{object_name}: local scheme = {local_scheme_color}, effective scheme = {effective_scheme_color}")
if effective_scheme_color == slides.SchemeColor.NOT_DEFINED:
print(f"{object_name}: direct RGB or another non-scheme fill; audit as theme-independent.")
else:
print(f"{object_name}: theme-dependent through {effective_scheme_color}.")
with slides.Presentation("input.pptx") as presentation:
for slide_index, slide in enumerate(presentation.slides):
for shape_index, shape in enumerate(slide.shapes):
shape_name = f"Slide {slide_index + 1}, shape {shape_index + 1}"
audit_fill(shape_name, shape.fill_format)
if isinstance(shape, slides.AutoShape):
for paragraph_index, paragraph in enumerate(shape.text_frame.paragraphs):
for portion_index, portion in enumerate(paragraph.portions):
portion_name = f"{shape_name}, paragraph {paragraph_index + 1}, portion {portion_index + 1}"
audit_fill(portion_name, portion.portion_format.fill_format)
La rama NOT_DEFINED proporciona una lista de auditoría de rellenos sólidos que no responderán a cambios en las ranuras de color del tema. Revisa esos objetos cuando una presentación debe seguir una nueva paleta de marca. El valor RGB reportado sigue mostrando la apariencia actual, mientras que el valor de esquema explica si esa apariencia está vinculada al tema.
Los objetos de formato efectivo son instantáneas. Después de cambiar el tema de la presentación, una anulación de tema o cualquier formato heredado, llama a get_effective nuevamente y lee un nuevo objeto IFillFormatEffectiveData antes de comparar o informar colores.
Leer valores efectivos del tema
Los objetos de tema sin procesar indican lo que está definido en un nivel concreto. Los valores efectivos indican lo que una diapositiva o forma utiliza realmente después de que se resuelvan la herencia y las anulaciones locales. Para una diapositiva, llama a BaseOverrideThemeManager.create_theme_effective. Para un fondo, usa Background.get_effective, y para un relleno, usa FillFormat.get_effective.
El siguiente ejemplo lee el tema efectivo, el fondo y el primer relleno de forma de una diapositiva:
import aspose.slides as slides
with slides.Presentation("input.pptx") as presentation:
slide = presentation.slides[0]
effective_theme = slide.theme_manager.create_theme_effective()
effective_background = slide.background.get_effective()
print(f"Effective major Latin font: {effective_theme.font_scheme.major.latin_font.font_name}")
print(f"Effective minor Latin font: {effective_theme.font_scheme.minor.latin_font.font_name}")
print(f"Effective background fill type: {effective_background.fill_format.fill_type}")
if len(slide.shapes) > 0:
effective_fill = slide.shapes[0].fill_format.get_effective()
print(f"First shape effective fill type: {effective_fill.fill_type}")
if effective_fill.fill_type == slides.FillType.SOLID:
print(f"First shape effective fill color: {effective_fill.solid_fill_color}")
Utiliza los datos efectivos para diagnósticos de renderizado, validación y comparaciones. Si inspeccionas solo Presentation.master_theme, puedes pasar por alto una anulación de maestro, diseño, diapositiva o forma que cambie la apariencia final.
FAQ
¿Aplicar un tema externo afecta a todas las diapositivas de la presentación?
No. IMasterSlide.apply_external_theme_to_depending_slides reasigna solo las diapositivas que dependen del maestro seleccionado. Las diapositivas que usan otros maestros conservan sus temas existentes.
¿Puedo aplicar un tema a una única diapositiva sin cambiar el maestro?
Sí. Utiliza el SlideThemeManager de la diapositiva e inicializa su tema de anulación. El cambio permanece local a esa diapositiva; las demás continúan heredando sus temas actuales.
¿Cuál es la forma más segura de trasladar un tema de una presentación a otra?
Al mover una diapositiva y preservar su apariencia original, clona el maestro de origen en el destino y clona la diapositiva con ese maestro mediante MasterSlideCollection.add_clone y SlideCollection.add_clone. Así se mantienen juntos el maestro, los diseños y el tema.
¿Cómo puedo ver los valores efectivos después de la herencia y las anulaciones?
Usa BaseOverrideThemeManager.create_theme_effective para una diapositiva o tema de diseño y los métodos de datos efectivos correspondientes para objetos de formato, como Background.get_effective y FillFormat.get_effective. Estas API devuelven los valores resueltos tras aplicar la herencia y las anulaciones.