def __init__(self,
title_font_color='black',
subtitle_font_color='#666666',
background_image="",
background_color="white",
grad_start_color="",
grad_end_color="",
grad_angle_deg=0,
grad_draw_style='linear',
show_date=False,
date_font_color='#666666',
footer="",
footer_font_color='#666666',
show_page_numbers=True,
page_number_font_color="#666666"):
"""
Main Presentation object
"""
self.filename = None
# keep a list of images for inclusion in ODP file
self.image_nameD = {
} # index=file system name, value=internal image name
self.sys_image_nameD = {
} # index=internal image name, value=file system name
self.image_nameL = [] # ordered list of internal image names
self.image_sizeD = {
} # index=internal image name, value=tuple of image size (w,h)
self.max_image_int = 0
self.title_font_color = title_font_color
self.subtitle_font_color = subtitle_font_color
self.background_image = background_image
if self.background_image:
self.internal_background_image = self.get_next_image_name(
background_image)
else:
self.internal_background_image = ''
self.background_color = getValidHexStr(background_color,
"#ffffff") # default to white
self.grad_start_color = grad_start_color
self.grad_end_color = grad_end_color
self.grad_angle = '%s' % (int(grad_angle_deg) * 10,
) # odp understands tenths of deg input
self.grad_draw_style = grad_draw_style
if self.internal_background_image:
self.ref_odp_filename = 'ppt_all_layouts_image.odp'
self.page_type = 'image' # "solidbg", "grad", "image"
elif self.grad_start_color and self.grad_end_color:
self.ref_odp_filename = 'ppt_all_layouts_grad.odp'
self.page_type = 'grad' # "solidbg", "grad", "image"
else:
self.ref_odp_filename = 'ppt_all_layouts_solidbg.odp'
self.page_type = 'solidbg' # "solidbg", "grad", "image"
# open reference odp file
self.full_odp_ref_path = os.path.join(here, 'templates',
self.ref_odp_filename)
self.odp_ref = ODPFile(self.full_odp_ref_path)
self.styles_xml_obj = StylesXML(self, self.odp_ref)
self.content_xml_obj = ContentXML(self, self.odp_ref)
# figure out max style:name (e.g. "a123")
self.odp_ref.styles_xml_obj.init_all_annn_style8name()
self.show_date = show_date
self.date_font_color = date_font_color
self.footer = footer
self.footer_font_color = footer_font_color
self.show_page_numbers = show_page_numbers
self.page_number_font_color = page_number_font_color
# style names will be in order, "a0", "a1", "a2", ...
self.new_content_styleL = [
] # style:style elements to be added to auto_styles
self.new_content_pageL = [
] # draw:page elements to be added to presentation
self.new_master_styleL = [
] # For each new_content_pageL item, there are many master-page style elements
self.new_master_page_styleL = [
] # For each new_content_pageL item, there is a style:master-page item
self.new_styles_office_stylesL = [
] # usually draw:gradient or draw:fill-image statements
self.new_content_styleD = {} # index="a123", value=style elem
#self.new_master_styleD = {} # index="a123", value=style elem
# style names and id values start at 0 (i.e. "a0", "a1", ... and "id0", "id1", ...)
#self.max_style_name_int = -1 # used for nameing styles (ex. draw:style-name="a123")
#self.max_draw_id_int = -1 # some internal use ???
self.max_style_name_int = self.odp_ref.styles_xml_obj.max_annn_def + 1000
self.max_draw_id_int = self.odp_ref.styles_xml_obj.max_idnnn_def + 1000
def __init__(self, title_font_color='black', subtitle_font_color='#666666',
background_image="", background_color="white",
grad_start_color="", grad_end_color="", grad_angle_deg=0, grad_draw_style='linear',
show_date=False, date_font_color='#666666',
footer="", footer_font_color='#666666',
show_page_numbers=True, page_number_font_color="#666666"):
"""
Main Presentation object
"""
self.filename = None
# keep a list of images for inclusion in ODP file
self.image_nameD = {} # index=file system name, value=internal image name
self.sys_image_nameD = {} # index=internal image name, value=file system name
self.image_nameL = [] # ordered list of internal image names
self.image_sizeD = {} # index=internal image name, value=tuple of image size (w,h)
self.max_image_int = 0
self.title_font_color = title_font_color
self.subtitle_font_color = subtitle_font_color
self.background_image = background_image
if self.background_image:
self.internal_background_image = self.get_next_image_name( background_image )
else:
self.internal_background_image = ''
self.background_color = getValidHexStr( background_color, "#ffffff" ) # default to white
self.grad_start_color = grad_start_color
self.grad_end_color = grad_end_color
self.grad_angle = '%s'%(int(grad_angle_deg)*10, ) # odp understands tenths of deg input
self.grad_draw_style = grad_draw_style
if self.internal_background_image:
self.ref_odp_filename = 'ppt_all_layouts_image.odp'
self.page_type = 'image' # "solidbg", "grad", "image"
elif self.grad_start_color and self.grad_end_color:
self.ref_odp_filename = 'ppt_all_layouts_grad.odp'
self.page_type = 'grad' # "solidbg", "grad", "image"
else:
self.ref_odp_filename = 'ppt_all_layouts_solidbg.odp'
self.page_type = 'solidbg' # "solidbg", "grad", "image"
# open reference odp file
self.full_odp_ref_path = os.path.join( here, 'templates', self.ref_odp_filename )
self.odp_ref = ODPFile( self.full_odp_ref_path )
self.styles_xml_obj = StylesXML( self, self.odp_ref )
self.content_xml_obj = ContentXML(self, self.odp_ref )
# figure out max style:name (e.g. "a123")
self.odp_ref.styles_xml_obj.init_all_annn_style8name()
self.show_date = show_date
self.date_font_color = date_font_color
self.footer = footer
self.footer_font_color = footer_font_color
self.show_page_numbers = show_page_numbers
self.page_number_font_color = page_number_font_color
# style names will be in order, "a0", "a1", "a2", ...
self.new_content_styleL = [] # style:style elements to be added to auto_styles
self.new_content_pageL = [] # draw:page elements to be added to presentation
self.new_master_styleL = [] # For each new_content_pageL item, there are many master-page style elements
self.new_master_page_styleL = [] # For each new_content_pageL item, there is a style:master-page item
self.new_styles_office_stylesL = [] # usually draw:gradient or draw:fill-image statements
self.new_content_styleD = {} # index="a123", value=style elem
#self.new_master_styleD = {} # index="a123", value=style elem
# style names and id values start at 0 (i.e. "a0", "a1", ... and "id0", "id1", ...)
#self.max_style_name_int = -1 # used for nameing styles (ex. draw:style-name="a123")
#self.max_draw_id_int = -1 # some internal use ???
self.max_style_name_int = self.odp_ref.styles_xml_obj.max_annn_def + 1000
self.max_draw_id_int = self.odp_ref.styles_xml_obj.max_idnnn_def + 1000
class Presentation(object):
"""
Creates OpenDocument Presentations for Microsoft PowerPoint, LibreOffice and OpenOffice.
Output is a ``*.odp`` file.
:keyword str title_font_color: (default=='black')
:keyword str subtitle_font_color: (default=='#666666')
:keyword str background_image: (default=="")
:keyword str background_color: (default=="white")
:keyword str grad_start_color: Color Gradient start color. If blank then not used (default=="")
:keyword str grad_end_color: Color Gradient end color. If blank then not used (default=="")
:keyword int grad_angle_deg: Color Gradient angle, in degrees (default==0)
:keyword str grad_draw_style: Color Gradient style, "linear", "radial", (default=='linear')
:keyword bool show_date: (default==False)
:keyword str date_font_color: (default=='#666666')
:keyword str footer: String displayed as footer on each slide (default=="")
:keyword str footer_font_color: (default=='#666666')
:keyword bool show_page_numbers: (default==True)
:keyword str page_number_font_color: (default=="#666666")
"""
def __init__(self,
title_font_color='black',
subtitle_font_color='#666666',
background_image="",
background_color="white",
grad_start_color="",
grad_end_color="",
grad_angle_deg=0,
grad_draw_style='linear',
show_date=False,
date_font_color='#666666',
footer="",
footer_font_color='#666666',
show_page_numbers=True,
page_number_font_color="#666666"):
"""
Main Presentation object
"""
self.filename = None
# keep a list of images for inclusion in ODP file
self.image_nameD = {
} # index=file system name, value=internal image name
self.sys_image_nameD = {
} # index=internal image name, value=file system name
self.image_nameL = [] # ordered list of internal image names
self.image_sizeD = {
} # index=internal image name, value=tuple of image size (w,h)
self.max_image_int = 0
self.title_font_color = title_font_color
self.subtitle_font_color = subtitle_font_color
self.background_image = background_image
if self.background_image:
self.internal_background_image = self.get_next_image_name(
background_image)
else:
self.internal_background_image = ''
self.background_color = getValidHexStr(background_color,
"#ffffff") # default to white
self.grad_start_color = grad_start_color
self.grad_end_color = grad_end_color
self.grad_angle = '%s' % (int(grad_angle_deg) * 10,
) # odp understands tenths of deg input
self.grad_draw_style = grad_draw_style
if self.internal_background_image:
self.ref_odp_filename = 'ppt_all_layouts_image.odp'
self.page_type = 'image' # "solidbg", "grad", "image"
elif self.grad_start_color and self.grad_end_color:
self.ref_odp_filename = 'ppt_all_layouts_grad.odp'
self.page_type = 'grad' # "solidbg", "grad", "image"
else:
self.ref_odp_filename = 'ppt_all_layouts_solidbg.odp'
self.page_type = 'solidbg' # "solidbg", "grad", "image"
# open reference odp file
self.full_odp_ref_path = os.path.join(here, 'templates',
self.ref_odp_filename)
self.odp_ref = ODPFile(self.full_odp_ref_path)
self.styles_xml_obj = StylesXML(self, self.odp_ref)
self.content_xml_obj = ContentXML(self, self.odp_ref)
# figure out max style:name (e.g. "a123")
self.odp_ref.styles_xml_obj.init_all_annn_style8name()
self.show_date = show_date
self.date_font_color = date_font_color
self.footer = footer
self.footer_font_color = footer_font_color
self.show_page_numbers = show_page_numbers
self.page_number_font_color = page_number_font_color
# style names will be in order, "a0", "a1", "a2", ...
self.new_content_styleL = [
] # style:style elements to be added to auto_styles
self.new_content_pageL = [
] # draw:page elements to be added to presentation
self.new_master_styleL = [
] # For each new_content_pageL item, there are many master-page style elements
self.new_master_page_styleL = [
] # For each new_content_pageL item, there is a style:master-page item
self.new_styles_office_stylesL = [
] # usually draw:gradient or draw:fill-image statements
self.new_content_styleD = {} # index="a123", value=style elem
#self.new_master_styleD = {} # index="a123", value=style elem
# style names and id values start at 0 (i.e. "a0", "a1", ... and "id0", "id1", ...)
#self.max_style_name_int = -1 # used for nameing styles (ex. draw:style-name="a123")
#self.max_draw_id_int = -1 # some internal use ???
self.max_style_name_int = self.odp_ref.styles_xml_obj.max_annn_def + 1000
self.max_draw_id_int = self.odp_ref.styles_xml_obj.max_idnnn_def + 1000
def get_next_a_style(self):
"""Returns a string like "a123" """
self.max_style_name_int += 1
return 'a%i' % self.max_style_name_int
def get_next_draw_id(self):
"""Returns a string like "id123" """
self.max_draw_id_int += 1
return 'id%i' % self.max_draw_id_int
def get_next_image_name(self, file_sys_name):
"""Returns a string like "image1", "image2", ... """
if file_sys_name in self.image_nameD:
return self.image_nameD[file_sys_name]
if not os.path.isfile(file_sys_name):
print('...WARNING... image file: "%s" NOT FOUND' % file_sys_name)
file_sys_name = os.path.join(here, 'templates',
'no_image_found.png')
head, tail = os.path.splitext(file_sys_name) # tail is usually ".png"
self.max_image_int += 1
int_name = 'image%i%s' % (self.max_image_int, tail)
self.image_nameD[file_sys_name] = int_name
self.sys_image_nameD[int_name] = file_sys_name
self.image_nameL.append(int_name)
self.image_sizeD[int_name] = get_image_size(file_sys_name)
return int_name
def launch_application(self):
"""
Will launch PowerPoint, LibreOffice or Openoffice using "os.startfile" or "open" or
"xdg-open" depending on the platform.
ONLY WORKS IF file has been saved.
"""
if self.filename is None:
print('=' * 75)
print('=' * 5,
'MUST SAVE FILE before launch_application will work.',
'=' * 5)
print('=' * 75)
return
#os.startfile( self.filename )
if sys.platform == "win32":
os.startfile(self.filename)
else:
opener = "open" if sys.platform == "darwin" else "xdg-open"
subprocess.call([opener, self.filename])
def add_office_styles(self, style_elem):
"""
Put draw:gradient and draw:image-fill into styles.xml
"""
office_styles = style_elem.find('office:styles')
for elem in self.new_styles_office_stylesL:
style_elem.acclimate_new_elem(elem)
office_styles.append(elem)
def save(self, filename='my_presentation.odp', launch=False):
"""
Saves Presentation to an odp file readable by Microsoft PowerPoint, LibreOffice or OpenOffice.
If the launch flag is set, will launch PowerPoint, LibreOffice or Openoffice using "os.startfile"
or "open" or "xdg-open" depending on the platform.
:keyword filename: Name of ods file to save (default=='my_presentation.odp')
:type filename: str or unicode
:keyword bool launch: If True, will launch PowerPoint, LibreOffice or OpenOffice (default==False)
:return: None
:rtype: None
"""
if not filename.lower().endswith('.odp'):
filename = filename + '.odp'
print('Saving odp file: %s' % filename)
self.filename = filename
zipfileobj = zipfile.ZipFile(filename, "w")
zipfile_insert(zipfileobj, 'meta.xml',
init_internal_odp_files.get_meta_xml_str())
zipfile_insert(zipfileobj, 'mimetype',
init_internal_odp_files.get_mimetype_str())
manifest_elem = init_internal_odp_files.get_manifest_elem()
zipfile_insert(zipfileobj, 'META-INF/manifest.xml', manifest_elem)
# put ODPSlides thumbnail into archive
full_png_path = os.path.join(here, 'templates', 'thumbnail.png')
zipfileobj.write(full_png_path, 'Thumbnails/thumbnail.png')
if self.image_nameL:
for img_name in self.image_nameL:
zipfileobj.write(self.sys_image_nameD[img_name],
'media/%s' % img_name)
# just duplicate reference file's styles.xml
self.styles_xml_obj.make_clean_copy()
self.styles_xml_obj.set_background()
if self.show_page_numbers:
self.styles_xml_obj.set_page_number_font_color()
if self.show_date:
self.styles_xml_obj.set_date_font_color()
if self.footer:
self.styles_xml_obj.set_footer_font_color()
self.styles_xml_obj.set_footer_text()
#self.set_bullets( self.styles_xml_obj.styles_tmplt.root )
styles_xml_str = self.styles_xml_obj.styles_tmplt.tostring().decode(
'utf-8')
styles_xml_str = styles_xml_str.replace(
' xmlns:number="urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0"',
'')
styles_xml_str = styles_xml_str.replace(
'<number:date-style ',
'<number:date-style xmlns:number="urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0" '
)
zipfile_insert(zipfileobj, 'styles.xml',
styles_xml_str.encode('utf-8'))
# Gets new empty content with each save
content_tmplt = self.content_xml_obj.content_tmplt # make a shorter var name for content_tmplt
#content_tmplt = init_internal_odp_files.get_empty_content_elem()
auto_style_elem = content_tmplt.find('office:automatic-styles')
body_pres_elem = content_tmplt.find('office:body/office:presentation')
for style_elem in self.new_content_styleL:
content_tmplt.acclimate_new_elem(style_elem)
auto_style_elem.append(style_elem)
for page in self.new_content_pageL:
content_tmplt.acclimate_new_elem(page.draw_page)
body_pres_elem.append(page.draw_page)
last_body_elem = init_internal_odp_files.get_final_presentation_elem()
content_tmplt.acclimate_new_elem(last_body_elem)
body_pres_elem.append(last_body_elem)
self.content_xml_obj.set_background()
if self.show_page_numbers:
self.content_xml_obj.set_show_page_number()
if self.show_date:
self.content_xml_obj.set_show_date()
if self.footer:
self.content_xml_obj.set_show_footer()
self.set_bullets(content_tmplt.root)
content_xml_str = content_tmplt.tostring().decode('utf-8')
# <<<<<<<<<<<<<<<< Add new content objects here ===================
zipfile_insert(zipfileobj, 'content.xml',
content_xml_str.encode('utf-8'))
zipfile_insert(zipfileobj, 'settings.xml',
init_internal_odp_files.get_settings_xml_str())
zipfileobj.close()
if launch:
self.launch_application()
def set_bullets(self, top_elem):
"""
I can't seem to find where my unicode bullet chars are getting messed up.
For now, set all bullets to the bullet character.
"""
bull_tag = force_to_tag('text:list-level-style-bullet')
for elem in top_elem.iter():
if elem.tag == bull_tag:
level = elem.get(force_to_tag('text:level'), '')
if level:
c = elem.get(force_to_tag('text:bullet-char'), '')
if len(c) > 1:
#i = int( level )
bchar = '\u2022' # BULLET_L[ i-1 ] # u'\u25CF'
elem.set(force_to_tag('text:bullet-char'), bchar)
#print(bchar, end='')
def add_a_new_page(self, new_page):
self.new_content_pageL.append(new_page)
new_page.set_page_number(len(self.new_content_pageL))
def add_title_chart(self,
title='My Title',
subtitle='My Subtitle',
title_font_color='',
subtitle_font_color='',
background_color="",
pcent_stretch_center=0,
pcent_stretch_content=0,
pcent_move_content_right=None,
pcent_move_content_up=None):
"""
Create a title slide with subtitle.
:keyword str title: (default=='My Title')
:keyword str subtitle: (default=='My Subtitle')
:keyword str title_font_color: (default=='')
:keyword str subtitle_font_color: (default=='')
:keyword str background_color: (default=="")
:return: None
:rtype: None
"""
if background_color:
background_color = getValidHexStr(background_color,
"#ffffff") # default to white
else:
background_color = self.background_color
inpD = {
'title': title,
'subtitle': subtitle,
'background_color': background_color,
'title_font_color': title_font_color,
'subtitle_font_color': subtitle_font_color,
'pcent_stretch_center': pcent_stretch_center,
'pcent_stretch_content': pcent_stretch_content,
'pcent_move_content_right': pcent_move_content_right,
'pcent_move_content_up': pcent_move_content_up
}
new_page = Page(self, disp_name="Title Slide", **inpD)
self.add_a_new_page(new_page)
def add_titled_outline_chart(self,
title='My Title',
title_font_color='',
outline='',
text_font_color='',
pcent_stretch_center=0,
pcent_stretch_content=0,
pcent_move_content_right=None,
pcent_move_content_up=None):
"""
Create a slide with a title and a text outline below.
An outline string is a single string with embedded carriage returns and tab characters.
It can also follow a python-like format of four spaces being equal to a tab character.
Tab characters(or 4 spaces) indicate indenting, carriage returns indicate a new line.
:keyword str title: (default=='My Title')
:keyword str title_font_color: (default=='')
:keyword str outline: The text of the outline in indented format (see above) (default=='')
:keyword str text_font_color: (default=='')
:keyword int pcent_stretch_center: (default==0)
:keyword int pcent_stretch_content: (default==0)
:keyword None pcent_move_content_right: Move content items left/right. (list of values from -100 to 100) (default==None)
:keyword None pcent_move_content_up: Move content items up/down. (list of values from -100 to 100) (default==None)
:return: None
:rtype: None
"""
inpD = {
'title': title,
'outline': outline,
'title_font_color': title_font_color,
'text_font_color': text_font_color,
'pcent_stretch_center': pcent_stretch_center,
'pcent_stretch_content': pcent_stretch_content,
'pcent_move_content_right': pcent_move_content_right,
'pcent_move_content_up': pcent_move_content_up
}
new_page = Page(self, disp_name="Title and Text", **inpD)
self.add_a_new_page(new_page)
def add_titled_two_outline_chart(self,
title='My Title',
title_font_color='',
outline='',
text_font_color='',
outline_2='',
text_2_font_color='',
pcent_stretch_center=0,
pcent_stretch_content=0,
pcent_move_content_right=None,
pcent_move_content_up=None):
"""
Create a slide with a title and two side-by-side text outlines.
An outline string is a single string with embedded carriage returns and tab characters.
It can also follow a python-like format of four spaces being equal to a tab character.
Tab characters(or 4 spaces) indicate indenting, carriage returns indicate a new line.
:keyword str title: (default=='My Title')
:keyword str title_font_color: (default=='')
:keyword str outline: The text of the outline in indented format (see above) (default=='')
:keyword str text_font_color: (default=='')
:keyword str outline_2: The text of outline #2 in indented format (see above) (default=='')
:keyword str text_2_font_color: (default=='')
:keyword int pcent_stretch_center: (default==0)
:keyword int pcent_stretch_content: (default==0)
:keyword None pcent_move_content_right: Move content items left/right. (list of values from -100 to 100) (default==None)
:keyword None pcent_move_content_up: Move content items up/down. (list of values from -100 to 100) (default==None)
:return: None
:rtype: None
"""
inpD = {
'title': title,
'outline': outline,
'title_font_color': title_font_color,
'text_font_color': text_font_color,
'outline_2': outline_2,
'text_2_font_color': text_2_font_color,
'pcent_stretch_center': pcent_stretch_center,
'pcent_stretch_content': pcent_stretch_content,
'pcent_move_content_right': pcent_move_content_right,
'pcent_move_content_up': pcent_move_content_up
}
new_page = Page(self, disp_name="Title and 2 Column Text", **inpD)
self.add_a_new_page(new_page)
def add_titled_image(self,
title='My Picture',
title_font_color='',
image_file='',
image_2_file='',
image_3_file='',
image_4_file='',
keep_aspect_ratio=True,
big_3rd_img_left=True,
pcent_stretch_center=0,
pcent_stretch_content=0,
pcent_move_content_right=None,
pcent_move_content_up=None):
"""
Create a slide with a title and 1 to 4 images.
:keyword str title: (default=='My Picture')
:keyword str title_font_color: (default=='')
:keyword str image_file: Full path to image #1 file on system (png, gif or jpg) (default=='')
:keyword str image_2_file: Full path to image #2 file on system (png, gif or jpg) (default=='')
:keyword str image_3_file: Full path to image #3 file on system (png, gif or jpg) (default=='')
:keyword str image_4_file: Full path to image #4 file on system (png, gif or jpg) (default=='')
:keyword bool keep_aspect_ratio: If true then adjust slide to maintain original aspect ratio (default==True)
:keyword bool big_3rd_img_left: For three images, if True, put big image on the left (default==True)
:keyword int pcent_stretch_center: Percentage by which to enlarge the central, content area (default==0)
:keyword int pcent_stretch_content: Percentage by which to enlarge image(s) (default==0)
:keyword None pcent_move_content_right: Move content items left/right. (list of values from -100 to 100) (default==None)
:keyword None pcent_move_content_up: Move content items up/down. (list of values from -100 to 100) (default==None)
:return: None
:rtype: None
"""
image_name = self.get_next_image_name(image_file)
inpD = {
'title': title,
'image_name': image_name,
'title_font_color': title_font_color,
'keep_aspect_ratio': keep_aspect_ratio,
'pcent_stretch_center': pcent_stretch_center,
'pcent_stretch_content': pcent_stretch_content,
'pcent_move_content_right': pcent_move_content_right,
'pcent_move_content_up': pcent_move_content_up
}
# do NOT do any checking of missing image inputs... just let the slide have blank entry
if image_4_file:
image2_name = self.get_next_image_name(image_2_file)
inpD['image_2_file'] = image2_name
image3_name = self.get_next_image_name(image_3_file)
inpD['image_3_file'] = image3_name
image4_name = self.get_next_image_name(image_4_file)
inpD['image_4_file'] = image4_name
new_page = Page(self, disp_name="Title and 4 Content", **inpD)
elif image_3_file:
image2_name = self.get_next_image_name(image_2_file)
inpD['image_2_file'] = image2_name
image3_name = self.get_next_image_name(image_3_file)
inpD['image_3_file'] = image3_name
if big_3rd_img_left:
new_page = Page(self,
disp_name="Title, Content, and 2 Content",
**inpD)
else:
new_page = Page(self,
disp_name="Title, 2 Content and Content",
**inpD)
elif image_2_file:
image2_name = self.get_next_image_name(image_2_file)
inpD['image_2_file'] = image2_name
new_page = Page(self, disp_name="Two Content", **inpD)
else:
new_page = Page(self, disp_name="Title and Content", **inpD)
self.add_a_new_page(new_page)
def add_titled_text_and_image(
self,
text_location='top', # can be "top", "bottom", "right", "left"
title='My Picture',
title_font_color='',
outline='',
text_font_color='',
image_file='',
keep_aspect_ratio=True,
image_2_file='',
pcent_stretch_center=0,
pcent_stretch_content=0,
pcent_move_content_right=None,
pcent_move_content_up=None):
"""
Create a slide with a text outline and 1 or 2 image(s).
An outline string is a single string with embedded carriage returns and tab characters.
It can also follow a python-like format of four spaces being equal to a tab character.
Tab characters(or 4 spaces) indicate indenting, carriage returns indicate a new line.
:keyword str text_location: Text location ("top", "bottom", "right", "left") (default=='top')
:keyword str title: (default=='My Picture')
:keyword str title_font_color: (default=='')
:keyword str outline: The text of the outline in indented format (see above) (default=='')
:keyword str text_font_color: (default=='')
:keyword str image_file: Full path to image #1 file on system (png, gif or jpg) (default=='')
:keyword str image_2_file: Full path to image #2 file on system (png, gif or jpg) (default=='')
:keyword bool keep_aspect_ratio: If true then adjust slide to maintain original aspect ratio (default==True)
:keyword int pcent_stretch_center: Percentage by which to enlarge the central, content area (default==0)
:keyword int pcent_stretch_content: Percentage by which to enlarge image(s) (default==0)
:keyword None pcent_move_content_right: Move content items left/right. (list of values from -100 to 100) (default==None)
:keyword None pcent_move_content_up: Move content items up/down. (list of values from -100 to 100) (default==None)
:return: None
:rtype: None
"""
image_name = self.get_next_image_name(image_file)
inpD = {
'title': title,
'title_font_color': title_font_color,
'outline': outline,
'text_font_color': text_font_color,
'image_name': image_name,
'keep_aspect_ratio': keep_aspect_ratio,
'pcent_stretch_center': pcent_stretch_center,
'pcent_stretch_content': pcent_stretch_content,
'pcent_move_content_right': pcent_move_content_right,
'pcent_move_content_up': pcent_move_content_up
}
if image_2_file:
image2_name = self.get_next_image_name(image_2_file)
inpD['image_2_file'] = image2_name
if text_location == 'left':
new_page = Page(self,
disp_name="Title, Text, and 2 Content",
**inpD)
elif text_location == 'top':
inpD['swap_svg_y_of_objects_and_outline'] = True
new_page = Page(self,
disp_name="Title and 2 Content over Text",
**inpD)
#new_page.swap_svg_y_of_objects_and_outline() # There is no layout for this, so fake it
elif text_location == 'bottom':
new_page = Page(self,
disp_name="Title and 2 Content over Text",
**inpD)
elif text_location == 'right':
new_page = Page(self,
disp_name="Title, 2 Content and Text",
**inpD)
else:
if text_location == 'left':
new_page = Page(self,
disp_name="Title, Text, and Content",
**inpD)
elif text_location == 'top':
new_page = Page(self,
disp_name="Title and Text over Content",
**inpD)
elif text_location == 'bottom':
new_page = Page(self,
disp_name="Title and Content over Text",
**inpD)
elif text_location == 'right':
new_page = Page(self,
disp_name="Title, Content and Text",
**inpD)
self.add_a_new_page(new_page)
def add_text_box_to_last_slide(self,
text_or_list='',
text_font_colors='',
x=8.0,
y=2.0):
"""
Add a text box to the last added slide in the presentation
"""
add_text_box(self,
text_or_list=text_or_list,
text_font_colors=text_font_colors,
x=x,
y=y)
class Presentation(object):
"""
Creates OpenDocument Presentations for Microsoft PowerPoint, LibreOffice and OpenOffice.
Output is a ``*.odp`` file.
:keyword str title_font_color: (default=='black')
:keyword str subtitle_font_color: (default=='#666666')
:keyword str background_image: (default=="")
:keyword str background_color: (default=="white")
:keyword str grad_start_color: Color Gradient start color. If blank then not used (default=="")
:keyword str grad_end_color: Color Gradient end color. If blank then not used (default=="")
:keyword int grad_angle_deg: Color Gradient angle, in degrees (default==0)
:keyword str grad_draw_style: Color Gradient style, "linear", "radial", (default=='linear')
:keyword bool show_date: (default==False)
:keyword str date_font_color: (default=='#666666')
:keyword str footer: String displayed as footer on each slide (default=="")
:keyword str footer_font_color: (default=='#666666')
:keyword bool show_page_numbers: (default==True)
:keyword str page_number_font_color: (default=="#666666")
"""
def __init__(self, title_font_color='black', subtitle_font_color='#666666',
background_image="", background_color="white",
grad_start_color="", grad_end_color="", grad_angle_deg=0, grad_draw_style='linear',
show_date=False, date_font_color='#666666',
footer="", footer_font_color='#666666',
show_page_numbers=True, page_number_font_color="#666666"):
"""
Main Presentation object
"""
self.filename = None
# keep a list of images for inclusion in ODP file
self.image_nameD = {} # index=file system name, value=internal image name
self.sys_image_nameD = {} # index=internal image name, value=file system name
self.image_nameL = [] # ordered list of internal image names
self.image_sizeD = {} # index=internal image name, value=tuple of image size (w,h)
self.max_image_int = 0
self.title_font_color = title_font_color
self.subtitle_font_color = subtitle_font_color
self.background_image = background_image
if self.background_image:
self.internal_background_image = self.get_next_image_name( background_image )
else:
self.internal_background_image = ''
self.background_color = getValidHexStr( background_color, "#ffffff" ) # default to white
self.grad_start_color = grad_start_color
self.grad_end_color = grad_end_color
self.grad_angle = '%s'%(int(grad_angle_deg)*10, ) # odp understands tenths of deg input
self.grad_draw_style = grad_draw_style
if self.internal_background_image:
self.ref_odp_filename = 'ppt_all_layouts_image.odp'
self.page_type = 'image' # "solidbg", "grad", "image"
elif self.grad_start_color and self.grad_end_color:
self.ref_odp_filename = 'ppt_all_layouts_grad.odp'
self.page_type = 'grad' # "solidbg", "grad", "image"
else:
self.ref_odp_filename = 'ppt_all_layouts_solidbg.odp'
self.page_type = 'solidbg' # "solidbg", "grad", "image"
# open reference odp file
self.full_odp_ref_path = os.path.join( here, 'templates', self.ref_odp_filename )
self.odp_ref = ODPFile( self.full_odp_ref_path )
self.styles_xml_obj = StylesXML( self, self.odp_ref )
self.content_xml_obj = ContentXML(self, self.odp_ref )
# figure out max style:name (e.g. "a123")
self.odp_ref.styles_xml_obj.init_all_annn_style8name()
self.show_date = show_date
self.date_font_color = date_font_color
self.footer = footer
self.footer_font_color = footer_font_color
self.show_page_numbers = show_page_numbers
self.page_number_font_color = page_number_font_color
# style names will be in order, "a0", "a1", "a2", ...
self.new_content_styleL = [] # style:style elements to be added to auto_styles
self.new_content_pageL = [] # draw:page elements to be added to presentation
self.new_master_styleL = [] # For each new_content_pageL item, there are many master-page style elements
self.new_master_page_styleL = [] # For each new_content_pageL item, there is a style:master-page item
self.new_styles_office_stylesL = [] # usually draw:gradient or draw:fill-image statements
self.new_content_styleD = {} # index="a123", value=style elem
#self.new_master_styleD = {} # index="a123", value=style elem
# style names and id values start at 0 (i.e. "a0", "a1", ... and "id0", "id1", ...)
#self.max_style_name_int = -1 # used for nameing styles (ex. draw:style-name="a123")
#self.max_draw_id_int = -1 # some internal use ???
self.max_style_name_int = self.odp_ref.styles_xml_obj.max_annn_def + 1000
self.max_draw_id_int = self.odp_ref.styles_xml_obj.max_idnnn_def + 1000
def get_next_a_style(self):
"""Returns a string like "a123" """
self.max_style_name_int += 1
return 'a%i'%self.max_style_name_int
def get_next_draw_id(self):
"""Returns a string like "id123" """
self.max_draw_id_int += 1
return 'id%i'%self.max_draw_id_int
def get_next_image_name(self, file_sys_name):
"""Returns a string like "image1", "image2", ... """
if file_sys_name in self.image_nameD:
return self.image_nameD[ file_sys_name ]
if not os.path.isfile( file_sys_name ):
print('...WARNING... image file: "%s" NOT FOUND'%file_sys_name)
file_sys_name = os.path.join(here, 'templates', 'no_image_found.png')
head, tail = os.path.splitext( file_sys_name ) # tail is usually ".png"
self.max_image_int += 1
int_name = 'image%i%s'%(self.max_image_int, tail)
self.image_nameD[ file_sys_name ] = int_name
self.sys_image_nameD[ int_name ] = file_sys_name
self.image_nameL.append( int_name )
self.image_sizeD[ int_name ] = get_image_size( file_sys_name )
return int_name
def launch_application(self):
"""
Will launch PowerPoint, LibreOffice or Openoffice using "os.startfile" or "open" or
"xdg-open" depending on the platform.
ONLY WORKS IF file has been saved.
"""
if self.filename is None:
print( '='*75 )
print( '='*5, 'MUST SAVE FILE before launch_application will work.' , '='*5)
print( '='*75 )
return
#os.startfile( self.filename )
if sys.platform == "win32":
os.startfile(self.filename)
else:
opener ="open" if sys.platform == "darwin" else "xdg-open"
subprocess.call([opener, self.filename])
def add_office_styles(self, style_elem):
"""
Put draw:gradient and draw:image-fill into styles.xml
"""
office_styles = style_elem.find( 'office:styles' )
for elem in self.new_styles_office_stylesL:
style_elem.acclimate_new_elem( elem )
office_styles.append( elem )
def save(self, filename='my_presentation.odp', launch=False):
"""
Saves Presentation to an odp file readable by Microsoft PowerPoint, LibreOffice or OpenOffice.
If the launch flag is set, will launch PowerPoint, LibreOffice or Openoffice using "os.startfile"
or "open" or "xdg-open" depending on the platform.
:keyword filename: Name of ods file to save (default=='my_presentation.odp')
:type filename: str or unicode
:keyword bool launch: If True, will launch PowerPoint, LibreOffice or OpenOffice (default==False)
:return: None
:rtype: None
"""
if not filename.lower().endswith('.odp'):
filename = filename + '.odp'
print('Saving odp file: %s'%filename)
self.filename = filename
zipfileobj = zipfile.ZipFile(filename, "w")
zipfile_insert( zipfileobj, 'meta.xml', init_internal_odp_files.get_meta_xml_str() )
zipfile_insert( zipfileobj, 'mimetype', init_internal_odp_files.get_mimetype_str())
manifest_elem = init_internal_odp_files.get_manifest_elem()
zipfile_insert( zipfileobj, 'META-INF/manifest.xml', manifest_elem)
# put ODPSlides thumbnail into archive
full_png_path = os.path.join( here, 'templates', 'thumbnail.png' )
zipfileobj.write( full_png_path, 'Thumbnails/thumbnail.png')
if self.image_nameL:
for img_name in self.image_nameL:
zipfileobj.write( self.sys_image_nameD[ img_name ], 'media/%s'%img_name)
# just duplicate reference file's styles.xml
self.styles_xml_obj.make_clean_copy()
self.styles_xml_obj.set_background()
if self.show_page_numbers:
self.styles_xml_obj.set_page_number_font_color()
if self.show_date:
self.styles_xml_obj.set_date_font_color()
if self.footer:
self.styles_xml_obj.set_footer_font_color()
self.styles_xml_obj.set_footer_text()
#self.set_bullets( self.styles_xml_obj.styles_tmplt.root )
styles_xml_str = self.styles_xml_obj.styles_tmplt.tostring().decode('utf-8')
styles_xml_str = styles_xml_str.replace(' xmlns:number="urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0"','')
styles_xml_str = styles_xml_str.replace( '<number:date-style ', '<number:date-style xmlns:number="urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0" ' )
zipfile_insert( zipfileobj, 'styles.xml', styles_xml_str.encode('utf-8'))
# Gets new empty content with each save
content_tmplt = self.content_xml_obj.content_tmplt # make a shorter var name for content_tmplt
#content_tmplt = init_internal_odp_files.get_empty_content_elem()
auto_style_elem = content_tmplt.find('office:automatic-styles')
body_pres_elem = content_tmplt.find('office:body/office:presentation')
for style_elem in self.new_content_styleL:
content_tmplt.acclimate_new_elem( style_elem )
auto_style_elem.append( style_elem )
for page in self.new_content_pageL:
content_tmplt.acclimate_new_elem( page.draw_page )
body_pres_elem.append( page.draw_page )
last_body_elem = init_internal_odp_files.get_final_presentation_elem()
content_tmplt.acclimate_new_elem( last_body_elem )
body_pres_elem.append( last_body_elem )
self.content_xml_obj.set_background()
if self.show_page_numbers:
self.content_xml_obj.set_show_page_number()
if self.show_date:
self.content_xml_obj.set_show_date()
if self.footer:
self.content_xml_obj.set_show_footer()
self.set_bullets( content_tmplt.root )
content_xml_str = content_tmplt.tostring().decode('utf-8')
# <<<<<<<<<<<<<<<< Add new content objects here ===================
zipfile_insert( zipfileobj, 'content.xml', content_xml_str.encode('utf-8'))
zipfile_insert( zipfileobj, 'settings.xml', init_internal_odp_files.get_settings_xml_str() )
zipfileobj.close()
if launch:
self.launch_application()
def set_bullets(self, top_elem ):
"""
I can't seem to find where my unicode bullet chars are getting messed up.
For now, set all bullets to the bullet character.
"""
bull_tag = force_to_tag( 'text:list-level-style-bullet' )
for elem in top_elem.iter():
if elem.tag == bull_tag:
level = elem.get(force_to_tag('text:level'),'')
if level:
c = elem.get(force_to_tag('text:bullet-char'), '')
if len(c)>1:
#i = int( level )
bchar = u'\u2022' # BULLET_L[ i-1 ] # u'\u25CF'
elem.set(force_to_tag('text:bullet-char'), bchar)
#print(bchar, end='')
def add_a_new_page(self, new_page ):
self.new_content_pageL.append( new_page )
new_page.set_page_number( len(self.new_content_pageL) )
def add_title_chart( self, title='My Title', subtitle='My Subtitle', title_font_color='',
subtitle_font_color='',background_color="",
pcent_stretch_center=0, pcent_stretch_content=0,
pcent_move_content_right=None, pcent_move_content_up=None):
"""
Create a title slide with subtitle.
:keyword str title: (default=='My Title')
:keyword str subtitle: (default=='My Subtitle')
:keyword str title_font_color: (default=='')
:keyword str subtitle_font_color: (default=='')
:keyword str background_color: (default=="")
:return: None
:rtype: None
"""
if background_color:
background_color = getValidHexStr( background_color, "#ffffff" ) # default to white
else:
background_color = self.background_color
inpD = {'title':title, 'subtitle':subtitle, 'background_color':background_color,
'title_font_color':title_font_color, 'subtitle_font_color':subtitle_font_color,
'pcent_stretch_center':pcent_stretch_center,
'pcent_stretch_content':pcent_stretch_content,
'pcent_move_content_right':pcent_move_content_right,
'pcent_move_content_up':pcent_move_content_up}
new_page = Page( self, disp_name="Title Slide", **inpD)
self.add_a_new_page( new_page )
def add_titled_outline_chart(self, title='My Title', title_font_color='',
outline='', text_font_color='',
pcent_stretch_center=0, pcent_stretch_content=0,
pcent_move_content_right=None, pcent_move_content_up=None):
"""
Create a slide with a title and a text outline below.
An outline string is a single string with embedded carriage returns and tab characters.
It can also follow a python-like format of four spaces being equal to a tab character.
Tab characters(or 4 spaces) indicate indenting, carriage returns indicate a new line.
:keyword str title: (default=='My Title')
:keyword str title_font_color: (default=='')
:keyword str outline: The text of the outline in indented format (see above) (default=='')
:keyword str text_font_color: (default=='')
:keyword int pcent_stretch_center: (default==0)
:keyword int pcent_stretch_content: (default==0)
:keyword None pcent_move_content_right: Move content items left/right. (list of values from -100 to 100) (default==None)
:keyword None pcent_move_content_up: Move content items up/down. (list of values from -100 to 100) (default==None)
:return: None
:rtype: None
"""
inpD = {'title':title, 'outline':outline,
'title_font_color':title_font_color, 'text_font_color':text_font_color,
'pcent_stretch_center':pcent_stretch_center,
'pcent_stretch_content':pcent_stretch_content,
'pcent_move_content_right':pcent_move_content_right,
'pcent_move_content_up':pcent_move_content_up}
new_page = Page( self, disp_name="Title and Text", **inpD)
self.add_a_new_page( new_page )
def add_titled_two_outline_chart(self, title='My Title', title_font_color='',
outline='', text_font_color='',
outline_2='', text_2_font_color='',
pcent_stretch_center=0, pcent_stretch_content=0,
pcent_move_content_right=None, pcent_move_content_up=None):
"""
Create a slide with a title and two side-by-side text outlines.
An outline string is a single string with embedded carriage returns and tab characters.
It can also follow a python-like format of four spaces being equal to a tab character.
Tab characters(or 4 spaces) indicate indenting, carriage returns indicate a new line.
:keyword str title: (default=='My Title')
:keyword str title_font_color: (default=='')
:keyword str outline: The text of the outline in indented format (see above) (default=='')
:keyword str text_font_color: (default=='')
:keyword str outline_2: The text of outline #2 in indented format (see above) (default=='')
:keyword str text_2_font_color: (default=='')
:keyword int pcent_stretch_center: (default==0)
:keyword int pcent_stretch_content: (default==0)
:keyword None pcent_move_content_right: Move content items left/right. (list of values from -100 to 100) (default==None)
:keyword None pcent_move_content_up: Move content items up/down. (list of values from -100 to 100) (default==None)
:return: None
:rtype: None
"""
inpD = {'title':title, 'outline':outline,
'title_font_color':title_font_color, 'text_font_color':text_font_color,
'outline_2':outline_2, 'text_2_font_color':text_2_font_color,
'pcent_stretch_center':pcent_stretch_center,
'pcent_stretch_content':pcent_stretch_content,
'pcent_move_content_right':pcent_move_content_right,
'pcent_move_content_up':pcent_move_content_up}
new_page = Page( self, disp_name="Title and 2 Column Text", **inpD)
self.add_a_new_page( new_page )
def add_titled_image(self, title='My Picture', title_font_color='',
image_file='', image_2_file='', image_3_file='', image_4_file='',
keep_aspect_ratio=True, big_3rd_img_left=True,
pcent_stretch_center=0, pcent_stretch_content=0,
pcent_move_content_right=None, pcent_move_content_up=None):
"""
Create a slide with a title and 1 to 4 images.
:keyword str title: (default=='My Picture')
:keyword str title_font_color: (default=='')
:keyword str image_file: Full path to image #1 file on system (png, gif or jpg) (default=='')
:keyword str image_2_file: Full path to image #2 file on system (png, gif or jpg) (default=='')
:keyword str image_3_file: Full path to image #3 file on system (png, gif or jpg) (default=='')
:keyword str image_4_file: Full path to image #4 file on system (png, gif or jpg) (default=='')
:keyword bool keep_aspect_ratio: If true then adjust slide to maintain original aspect ratio (default==True)
:keyword bool big_3rd_img_left: For three images, if True, put big image on the left (default==True)
:keyword int pcent_stretch_center: Percentage by which to enlarge the central, content area (default==0)
:keyword int pcent_stretch_content: Percentage by which to enlarge image(s) (default==0)
:keyword None pcent_move_content_right: Move content items left/right. (list of values from -100 to 100) (default==None)
:keyword None pcent_move_content_up: Move content items up/down. (list of values from -100 to 100) (default==None)
:return: None
:rtype: None
"""
image_name = self.get_next_image_name( image_file )
inpD = {'title':title, 'image_name':image_name, 'title_font_color':title_font_color,
'keep_aspect_ratio':keep_aspect_ratio,
'pcent_stretch_center':pcent_stretch_center,
'pcent_stretch_content':pcent_stretch_content,
'pcent_move_content_right':pcent_move_content_right,
'pcent_move_content_up':pcent_move_content_up}
# do NOT do any checking of missing image inputs... just let the slide have blank entry
if image_4_file:
image2_name = self.get_next_image_name( image_2_file )
inpD['image_2_file'] = image2_name
image3_name = self.get_next_image_name( image_3_file )
inpD['image_3_file'] = image3_name
image4_name = self.get_next_image_name( image_4_file )
inpD['image_4_file'] = image4_name
new_page = Page( self, disp_name="Title and 4 Content", **inpD)
elif image_3_file:
image2_name = self.get_next_image_name( image_2_file )
inpD['image_2_file'] = image2_name
image3_name = self.get_next_image_name( image_3_file )
inpD['image_3_file'] = image3_name
if big_3rd_img_left:
new_page = Page( self, disp_name="Title, Content, and 2 Content", **inpD)
else:
new_page = Page( self, disp_name="Title, 2 Content and Content", **inpD)
elif image_2_file:
image2_name = self.get_next_image_name( image_2_file )
inpD['image_2_file'] = image2_name
new_page = Page( self, disp_name="Two Content", **inpD)
else:
new_page = Page( self, disp_name="Title and Content", **inpD)
self.add_a_new_page( new_page )
def add_titled_text_and_image(self, text_location='top', # can be "top", "bottom", "right", "left"
title='My Picture', title_font_color='',
outline='', text_font_color='',
image_file='', keep_aspect_ratio=True, image_2_file='',
pcent_stretch_center=0, pcent_stretch_content=0,
pcent_move_content_right=None, pcent_move_content_up=None):
"""
Create a slide with a text outline and 1 or 2 image(s).
An outline string is a single string with embedded carriage returns and tab characters.
It can also follow a python-like format of four spaces being equal to a tab character.
Tab characters(or 4 spaces) indicate indenting, carriage returns indicate a new line.
:keyword str text_location: Text location ("top", "bottom", "right", "left") (default=='top')
:keyword str title: (default=='My Picture')
:keyword str title_font_color: (default=='')
:keyword str outline: The text of the outline in indented format (see above) (default=='')
:keyword str text_font_color: (default=='')
:keyword str image_file: Full path to image #1 file on system (png, gif or jpg) (default=='')
:keyword str image_2_file: Full path to image #2 file on system (png, gif or jpg) (default=='')
:keyword bool keep_aspect_ratio: If true then adjust slide to maintain original aspect ratio (default==True)
:keyword int pcent_stretch_center: Percentage by which to enlarge the central, content area (default==0)
:keyword int pcent_stretch_content: Percentage by which to enlarge image(s) (default==0)
:keyword None pcent_move_content_right: Move content items left/right. (list of values from -100 to 100) (default==None)
:keyword None pcent_move_content_up: Move content items up/down. (list of values from -100 to 100) (default==None)
:return: None
:rtype: None
"""
image_name = self.get_next_image_name( image_file )
inpD = {'title':title, 'title_font_color':title_font_color,
'outline':outline, 'text_font_color':text_font_color,
'image_name':image_name, 'keep_aspect_ratio':keep_aspect_ratio,
'pcent_stretch_center':pcent_stretch_center,
'pcent_stretch_content':pcent_stretch_content,
'pcent_move_content_right':pcent_move_content_right,
'pcent_move_content_up':pcent_move_content_up}
if image_2_file:
image2_name = self.get_next_image_name( image_2_file )
inpD['image_2_file'] = image2_name
if text_location == 'left':
new_page = Page( self, disp_name= "Title, Text, and 2 Content", **inpD)
elif text_location == 'top':
inpD['swap_svg_y_of_objects_and_outline'] = True
new_page = Page( self, disp_name= "Title and 2 Content over Text", **inpD)
#new_page.swap_svg_y_of_objects_and_outline() # There is no layout for this, so fake it
elif text_location == 'bottom':
new_page = Page( self, disp_name= "Title and 2 Content over Text", **inpD)
elif text_location == 'right':
new_page = Page( self, disp_name= "Title, 2 Content and Text", **inpD)
else:
if text_location == 'left':
new_page = Page( self, disp_name= "Title, Text, and Content", **inpD)
elif text_location == 'top':
new_page = Page( self, disp_name= "Title and Text over Content", **inpD)
elif text_location == 'bottom':
new_page = Page( self, disp_name= "Title and Content over Text", **inpD)
elif text_location == 'right':
new_page = Page( self, disp_name= "Title, Content and Text", **inpD)
self.add_a_new_page( new_page )
def add_text_box_to_last_slide(self, text_or_list='', text_font_colors='',
x=8.0, y=2.0):
"""
Add a text box to the last added slide in the presentation
"""
add_text_box( self, text_or_list=text_or_list, text_font_colors=text_font_colors,
x=x, y=y)