====== python-pptx ======
=== リンク ===
  * [[https://python-pptx.readthedocs.io/en/latest/|公式ドキュメント]]


===== はじめに =====

メインは Presentation クラス。
  * ''pptx.Presentation()'' -> %%<%%Presentation%%>%%
    * ''core_properties'' -> %%<%%CorePropertiesPart%%>%%
    * ''slides'' -> %%<%%Slides%%>%%
      * ''[i]'' -> %%<%%Slide%%>%%
    * ''slide_masters'' -> %%<%%SlideMasters%%>%%
      * ''[i]'' -> %%<%%SlideMaster%%>%%
    * ''slide_layouts'' -> %%<%%SlideLayouts%%>%%
      * ''[i]'' -> %%<%%SlideLayout%%>%%
    * ''slide_master'' -> %%<%%SlideMaster%%>%% = ''slide_masters[0]''

  * ''pptx.Presentation().slides[i]'' -> %%<%%Slide%%>%%
    * ''shapes'' -> %%<%%SlideShapes%%>%%
      * ''[i]'' -> 何らか\\ ''pptx.shapes.placeholder.SlideSPlaceholder''\\ or ''pptx.shapes.autoshape.Shape'' or etc.

Util にはインチ/cm/pt を powerpoint内単位の長さに変換する関数などがある。
  * ''pptx''
    * ''Inches''
    * ''Cm''
    * ''Pt''

  * 色のオブジェクト ''pptx.dml.color.RGBColor''
  * 形状のオブジェクト一覧 ''pptx.enum.shapes.MSO_SHAPE''
  * 線のスタイル一覧 ''pptx.enum.shapes.MSO_CONNECTOR_TYPE''
  * 色のテーマ ''pptx.enum.dml.MSO_THEME_COLOR''


===== 形状 =====
  * ''OVAL'' : 円/楕円形
  * ''RECTANGLE'' : 矩形
  * ''ROUNDED_RECTANGLE'' : 角丸矩形


===== メモ =====

<code>
Presentation
    - core_properties   : <CorePropertiesPart>
    - element
    - notes_master
    - part
    - save              : 保存
    - slide_layouts     : スライド形式 (例:「タイトルとコンテンツ」)
    - slides            : <Slides> スライド一覧
    - slide_height      :
    - slide_width       :
    - slide_master      : 現在適用されているスライドマスター
    - slide_masters     : スライドマスター一覧
    (- _element - _part - _slide_masters - _slides)

# pptxファイルの設定
CorePropertiesPart
    - after_unmarshal
    - author
    - before_marshal
    - blob
    - category
    - comments
    - content_status
    - content_type
    - created
    - default
    - drop_rel
    - identifier
    - keywords
    - language
    - last_modified_by
    - last_printed
    - load
    - load_rel
    - modified
    - package
    - part
    - part_related_by
    - partname
    - relate_to
    - related_parts
    - rels
    - revision
    - subject
    - target_ref
    - title
    - version

# スライド一覧
Slides
    - add_slide
    - element
    - get
    - index
    - parent
    - part

# スライド
Slide
    - background
    - element
    - follow_master_background
    - has_notes_slide
    - name
    - notes_slide
    - part
    - placeholders
    - shapes
    - slide_id
    - slide_layout

# スライドマスター内レイアウト一覧
SlideLayouts (iterable, subscriptable)
    - element
    - get_by_name
    - index
    - parent
    - part
    - remove

# スライドレイアウト
SlideLayout
    - background
    - element
    - iter_cloneable_placeholders
    - name
    - part
    - placeholders
    - shapes
    - slide_master
    - used_by_slides

# 複数あるスライドマスターの一覧、先頭にあるのが有効なスライドマスターとなる？
SlideMasters (iterable, subscriptable)
    - element
    - parent
    - part
    - [0] : SlideMaster

# 現在有効なスライドマスターのこと？
SlideMaster
    - background
    - element
    - name
    - part
    - placeholders
    - shapes
    - slide_layouts
</code>


<code>
# 図形
Shape
    - adjustments
    - auto_shape_type
    - click_action
    - element
    - fill
    - get_or_add_ln
    - has_chart
    - has_table
    - has_text_frame
    - height
    - is_placeholder
    - left
    - line
    - ln
    - name
    - part
    - placeholder_format
    - rotation
    - shadow
    - shape_id
    - shape_type
    - text
    - text_frame
    - top
    - width
</code>


<code>
MSO_SHAPE

    - from_xml
    - to_xml
    - validate
</code>