### Preset Geometry Shapes (XML)

Source: https://context7.com/elliottcarlson/pptx-viewer/llms.txt

Specifies a shape type from the standard library instead of custom geometry. Examples include a rectangle, a rounded rectangle with adjustable corner radius, and a right arrow. Common preset values are listed.

```xml
<!-- Rectangle shape -->
<a:prstGeom prst="rect">
  <a:avLst/>
</a:prstGeom>

<!-- Rounded rectangle with corner radius adjustment -->
<a:prstGeom prst="roundRect">
  <a:avLst>
    <a:gd name="adj" fmla="val 16667"/>
  </a:avLst>
</a:prstGeom>

<!-- Arrow shape -->
<a:prstGeom prst="rightArrow">
  <a:avLst>
    <a:gd name="adj1" fmla="val 50000"/>
    <a:gd name="adj2" fmla="val 50000"/>
  </a:avLst>
</a:prstGeom>

<!-- Common preset values: rect, ellipse, triangle, diamond,
     roundRect, rightArrow, leftArrow, star5, heart, etc. -->
```

--------------------------------

### ZIP File Extraction and Slide XML Access with zip.js

Source: https://context7.com/elliottcarlson/pptx-viewer/llms.txt

Demonstrates how to use the zip.js library to read and extract content from ZIP archives, specifically PPTX files. It includes functions to get all entries within a ZIP file and extract the text content of a specific entry, focusing on filtering and processing slide XML files.

```javascript
// Model for handling ZIP file operations
var model = (function() {
  return {
    // Get all entries from a ZIP file
    getEntries: function(file, onend) {
      zip.createReader(new zip.BlobReader(file), function(zipReader) {
        zipReader.getEntries(onend);
      }, onerror);
    },

    // Extract text content from a specific entry
    getEntryFile: function(entry, onend, onprogress) {
      var writer = new zip.TextWriter();
      entry.getData(writer, function(content) {
        onend(content);
      }, onprogress);
    }
  };
})();

// Example: Unzip and list slides
function unzip(zip) {
  var files = [];
  model.getEntries(zip, function(entries) {
    entries.forEach(function(entry) {
      // Filter for slide XML files only
      if (entry.filename.match(/^ppt\/slides\/\w+\.xml$/i)) {
        files.push(entry.filename);
        entries[entry.filename] = entry;
      }
    });
    files.sort();
    // Display slide list to user
  });
}
```

--------------------------------

### Solid Color Fill Options (XML)

Source: https://context7.com/elliottcarlson/pptx-viewer/llms.txt

Defines a solid color fill for shapes, lines, or text using different color models. Examples include RGB hex color, theme scheme color with luminosity adjustments, and RGB percentages.

```xml
<!-- Solid fill with RGB hex color -->
<a:solidFill>
  <a:srgbClr val="FF5733"/>
</a:solidFill>

<!-- Solid fill with theme scheme color -->
<a:solidFill>
  <a:schemeClr val="accent1">
    <a:lumMod val="75000"/>
    <a:lumOff val="25000"/>
  </a:schemeClr>
</a:solidFill>

<!-- Solid fill with RGB percentages -->
<a:solidFill>
  <a:scrgbClr r="100000" g="50000" b="25000"/>
</a:solidFill>
```

--------------------------------

### 2D Transform Properties (XML)

Source: https://context7.com/elliottcarlson/pptx-viewer/llms.txt

Specifies the position, size, rotation, and flip attributes for shapes and groups. The example demonstrates transform with rotation and positioning, including offset, extents, and child properties for grouped objects. Units are EMUs for position/size and 60000ths of a degree for rotation.

```xml
<!-- Transform with rotation and positioning -->
<a:xfrm rot="5400000" flipH="false" flipV="false">
  <!-- Offset: position from top-left (in EMUs) -->
  <a:off x="914400" y="914400"/>
  <!-- Extents: width and height (in EMUs) -->
  <a:ext cx="2743200" cy="1828800"/>
  <!-- Child offset for grouped objects -->
  <a:chOff x="0" y="0"/>
  <!-- Child extents for grouped objects -->
  <a:chExt cx="2743200" cy="1828800"/>
</a:xfrm>

<!-- Note: 914400 EMUs = 1 inch, rotation is in 60000ths of a degree -->
```

--------------------------------

### Shape Text Body Content (XML)

Source: https://context7.com/elliottcarlson/pptx-viewer/llms.txt

Contains all visible text and text-related properties for a shape, supporting multiple paragraphs. The example shows a text body with centered, bold text using a specific font size and color fill.

```xml
<!-- Text body with styled paragraph -->
<p:txBody>
  <a:bodyPr wrap="square" rtlCol="0" anchor="ctr"/>
  <a:lstStyle/>
  <a:p>
    <a:pPr algn="ctr"/>
    <a:r>
      <a:rPr lang="en-US" sz="2400" b="1">
        <a:solidFill>
          <a:srgbClr val="000000"/>
        </a:solidFill>
      </a:rPr>
      <a:t>Bold Centered Text</a:t>
    </a:r>
    <a:endParaRPr lang="en-US"/>
  </a:p>
</p:txBody>
```

--------------------------------

### Contextual Documentation Loading on XML Element Click

Source: https://context7.com/elliottcarlson/pptx-viewer/llms.txt

Implements functionality to detect the XML element under the cursor in the CodeMirror editor and load corresponding documentation. It parses the current line to find an XML tag, constructs a file path for the documentation (e.g., 'docs/p_sp.md'), and uses jQuery's AJAX to fetch and display the markdown content.

```javascript
// Detect XML element under cursor and load documentation
editor.on('cursorActivity', function(editor) {
  var line = editor.getLine(editor.getCursor(true).line);
  var found = line.match(/<\??\/?([\w:]+).*?>/i);

  if (found && found[1]) {
    // Convert element name to documentation file path
    // e.g., "p:sp" becomes "docs/p_sp.md"
    var file = 'docs/' + found[1].replace(':', '_') + '.md';

    $.ajax({
      type: 'GET',
      url: file,
      success: function(msg) {
        loadMarkdown(msg);
      },
      error: function(xhr, ajaxOptions, thrownError) {
        loadMarkdown('# No documentation available yet for `<' + found[1] + '>`.\n\n' +
          '[Why not add it with a pull request?](https://github.com/elliottcarlson/pptx-viewer)');
      }
    });
  }
});
```

--------------------------------

### CodeMirror Editor Initialization and Event Handling

Source: https://github.com/elliottcarlson/pptx-viewer/blob/gh-pages/index.html

This JavaScript code initializes a CodeMirror editor to display XML content. It sets up the editor with specific modes, themes, and line number display. It also includes an event listener for cursor activity to dynamically load Markdown documentation based on the XML tag under the cursor.

```javascript
$(document).ready(function() {
if ($('#code').val().length <= 0) {
for (var i = 0; i < 100; i++) {
$('#code').val($('#code').val() + '\n');
}
}
editor = CodeMirror.fromTextArea(document.getElementById('code'), {
mode: 'application/xml',
styleActiveLine: true,
lineNumbers: true,
lineWrapping: true,
readOnly: true,
theme: 'solarized dark'
});
var current_file = '';
editor.on('cursorActivity', function(editor) {
var line = editor.getLine(editor.getCursor(true).line);
var found = line.match(/<\??\/?([\w:]+).*?>/i);
if (found && found[1]) {
var file = 'docs/' + found[1].replace(':', '_') + '.md';
if (file !== current_file) {
$.ajax({
type: 'GET',
url: file,
success: function(msg) {
current_file = file;
loadMarkdown(msg);
},
error: function(xhr, ajaxOptions, thrownError) {
current_file = '';
loadMarkdown('# No documentation available yet for \`<' + found[1] + '>\`.' + "\n\n" + '[Why not add it with a pull request?](https://github.com/elliottcarlson/pptx-viewer)');
}
});
}
} else {
current_file = '';
loadMarkdown('# Nothing available for ' + found[1]);
}
});
});
```

--------------------------------

### HTML Structure and CodeMirror Initialization for PPTX Viewer

Source: https://context7.com/elliottcarlson/pptx-viewer/llms.txt

Provides the HTML structure for the viewer's content wrapper, including a textarea for code display, and initializes CodeMirror for syntax highlighting and editing of XML content. It sets up the editor with specific modes and themes for an optimal viewing experience.

```html
<!-- HTML structure for the viewer -->
<div id="content-wrapper">
  <div id="content">
    <div id="editor">
      <form>
        <textarea id="code" name="code"></textarea>
      </form>
    </div>
    <div id="markdown">
    </div>
  </div>
</div>

<!-- Initialize CodeMirror editor -->
<script>
  editor = CodeMirror.fromTextArea(document.getElementById('code'), {
    mode: 'application/xml',
    styleActiveLine: true,
    lineNumbers: true,
    lineWrapping: true,
    readOnly: true,
    theme: 'solarized dark'
  });
</script>
```

--------------------------------

### CT_GeomGuideList Schema Definition (XSD)

Source: https://github.com/elliottcarlson/pptx-viewer/blob/gh-pages/docs/a_avLst.md

This snippet shows the XML Schema Definition (XSD) for the CT_GeomGuideList complex type, which defines the structure of the a:avLst element. It indicates that the element can contain zero or more 'gd' (Shape Guide) child elements.

```xml
<xsd:complexType name="CT_GeomGuideList">
  <xsd:sequence>
    <xsd:element name="gd" type="CT_GeomGuide" minOccurs="0" maxOccurs="unbounded"/>
  </xsd:sequence>
</xsd:complexType>
```

--------------------------------

### XML Formatting with vkbeautify for Slide Content

Source: https://context7.com/elliottcarlson/pptx-viewer/llms.txt

Shows how to load slide XML content and format it for display using the vkbeautify library. The `loadSlide` function takes a zip entry, extracts its text content, and then uses `vkbeautify.xml` to format the XML with specified indentation before setting it in the CodeMirror editor.

```javascript
// Load and display formatted slide XML
function loadSlide(entry) {
  model.getEntryFile(entry, function(content) {
    // Format XML with 2-space indentation
    editor.setValue(vkbeautify.xml(content, 2));
  }, function(current, total) {
    // Progress callback
  });
}
```

--------------------------------

### Markdown Rendering to HTML with Markdown.Converter

Source: https://context7.com/elliottcarlson/pptx-viewer/llms.txt

Details the initialization and usage of the Markdown.Converter library for rendering markdown content into HTML. The `loadMarkdown` function takes markdown text, converts it using the initialized converter (with extra features enabled), and then updates the innerHTML of a specified DOM element with the resulting HTML.

```javascript
// Initialize markdown converter with extras
var converter = new Markdown.Converter();
Markdown.Extra.init(converter);

// Render markdown content to HTML
function loadMarkdown(content) {
  var html = converter.makeHtml(content);
  document.getElementById('markdown').innerHTML = html;
}
```

--------------------------------

### Preset Color Element

Source: https://github.com/elliottcarlson/pptx-viewer/blob/gh-pages/docs/a_prstClr.md

Documentation for the &lt;a:prstClr&gt; element, which specifies a color bound to a predefined collection of colors.

```APIDOC
## Preset Color Element

### Description
This element specifies a color which is bound to one of a predefined collection of colors.

### Method
N/A (This is an XML element description, not an API endpoint)

### Endpoint
N/A

### Parameters
#### Path Parameters
N/A

#### Query Parameters
N/A

#### Request Body
N/A

### Request Example
N/A

### Response
#### Success Response (200)
N/A

#### Response Example
N/A

### Element Information
**Namespace**: http://schemas.openxmlformats.org/drawingml/2006/main
**Type**: a:CT_PresetColor

### Parent Elements
- a:EG_ColorChoice
- a:alphaInv (a:CT_AlphaInverseEffect)
- p:clrMru (a:CT_ColorMRU)
- a:clrRepl (a:CT_ColorReplaceEffect)
- a:custClr (a:CT_CustomColor)
- a:duotone (a:CT_DuotoneEffect)
- a:fontRef (a:CT_FontReference)
- a:glow (a:CT_GlowEffect)
- a:gs (a:CT_GradientStop)
- a:innerShdw (a:CT_InnerShadowEffect)
- a:outerShdw (a:CT_OuterShadowEffect)
- a:prstShdw (a:CT_PresetShadowEffect)
- a:solidFill (a:CT_SolidColorFillProperties)
- a:tcTxStyle (a:CT_TableStyleTextStyle)
- a:lnRef (a:CT_StyleMatrixReference)
- a:fillRef (a:CT_StyleMatrixReference)
- a:effectRef (a:CT_StyleMatrixReference)
- p:bgRef (a:CT_StyleMatrixReference)
- draw-diag:fillClrLst (draw-diag:CT_Colors)
- draw-diag:linClrLst (draw-diag:CT_Colors)
- draw-diag:effectClrLst (draw-diag:CT_Colors)
- draw-diag:txLinClrLst (draw-diag:CT_Colors)
- draw-diag:txFillClrLst (draw-diag:CT_Colors)
- draw-diag:txEffectClrLst (draw-diag:CT_Colors)
- a:dk1 (a:CT_Color)
- a:lt1 (a:CT_Color)
- a:dk2 (a:CT_Color)
- a:lt2 (a:CT_Color)
- a:accent1 (a:CT_Color)
- a:accent2 (a:CT_Color)
- a:accent3 (a:CT_Color)
- a:accent4 (a:CT_Color)
- a:accent5 (a:CT_Color)
- a:accent6 (a:CT_Color)
- a:hlink (a:CT_Color)
- a:folHlink (a:CT_Color)
- a:extrusionClr (a:CT_Color)
- a:contourClr (a:CT_Color)
- a:clrFrom (a:CT_Color)
- a:clrTo (a:CT_Color)
- a:fgClr (a:CT_Color)
- a:bgClr (a:CT_Color)
- a:buClr (a:CT_Color)
- a:highlight (a:CT_Color)
- p:clrVal (a:CT_Color)
- p:from (a:CT_Color)
- p:to (a:CT_Color)
- p:penClr (a:CT_Color)

### Child Elements
- **a:tint** (a:CT_PositiveFixedPercentage) - Occ: [0..*] - Description: Tint
- **a:shade** (a:CT_PositiveFixedPercentage) - Occ: [0..*] - Description: Shade
- **a:comp** (a:CT_ComplementTransform) - Occ: [0..*] - Description: Complement
- **a:inv** (a:CT_InverseTransform) - Occ: [0..*] - Description: Inverse
- **a:gray** (a:CT_GrayscaleTransform) - Occ: [0..*] - Description: Gray
- **a:alpha** (a:CT_PositiveFixedPercentage) - Occ: [0..*] - Description: Alpha
- **a:alphaOff** (a:CT_FixedPercentage) - Occ: [0..*] - Description: Alpha Offset
- **a:alphaMod** (a:CT_PositivePercentage) - Occ: [0..*] - Description: Alpha Modulation
- **a:hue** (a:CT_PositiveFixedAngle) - Occ: [0..*] - Description: Hue
- **a:hueOff** (a:CT_Angle) - Occ: [0..*] - Description: Hue Offset
- **a:hueMod** (a:CT_PositivePercentage) - Occ: [0..*] - Description: Hue Modulate
- **a:sat** (a:CT_Percentage) - Occ: [0..*] - Description: Saturation
- **a:satOff** (a:CT_Percentage) - Occ: [0..*] - Description: Saturation Offset
- **a:satMod** (a:CT_Percentage) - Occ: [0..*] - Description: Saturation Modulation
- **a:lum** (a:CT_Percentage) - Occ: [0..*] - Description: Luminance
- **a:lumOff** (a:CT_Percentage) - Occ: [0..*] - Description: Luminance Offset
- **a:lumMod** (a:CT_Percentage) - Occ: [0..*] - Description: Luminance Modulation
- **a:red** (a:CT_Percentage) - Occ: [0..*] - Description: Red
- **a:redOff** (a:CT_Percentage) - Occ: [0..*] - Description: Red Offset
- **a:redMod** (a:CT_Percentage) - Occ: [0..*] - Description: Red Modulation
- **a:green** (a:CT_Percentage) - Occ: [0..*] - Description: Green
- **a:greenOff** (a:CT_Percentage) - Occ: [0..*] - Description: Green Offset
- **a:greenMod** (a:CT_Percentage) - Occ: [0..*] - Description: Green Modification
- **a:blue** (a:CT_Percentage) - Occ: [0..*] - Description: Blue
- **a:blueOff** (a:CT_Percentage) - Occ: [0..*] - Description: Blue Offset
- **a:blueMod** (a:CT_Percentage) - Occ: [0..*] - Description: Blue Modification
- **a:gamma** (a:CT_GammaTransform) - Occ: [0..*] - Description: Gamma
- **a:invGamma** (a:CT_InverseGammaTransform) - Occ: [0..*] - Description: Inverse Gamma

### Attributes
- **val** (a:ST_PresetColorVal) - Occ: [1..1] - Description: Value - Default: N/A
```

--------------------------------

### Shape Element Definition (XML)

Source: https://context7.com/elliottcarlson/pptx-viewer/llms.txt

Represents a single shape within a slide, encompassing its geometry, visual properties, and text content. The example shows a shape with text, including non-visual properties, shape properties like transform and geometry, and the text body.

```xml
<!-- Example shape with text -->
<p:sp useBgFill="false">
  <p:nvSpPr>
    <!-- Non-visual properties -->
    <p:cNvPr id="2" name="Title 1"/>
    <p:cNvSpPr/>
    <p:nvPr/>
  </p:nvSpPr>
  <p:spPr>
    <!-- Shape properties (geometry, fill, outline) -->
    <a:xfrm>
      <a:off x="457200" y="274638"/>
      <a:ext cx="8229600" cy="1143000"/>
    </a:xfrm>
    <a:prstGeom prst="rect">
      <a:avLst/>
    </a:prstGeom>
  </p:spPr>
  <p:txBody>
    <!-- Text content -->
    <a:bodyPr/>
    <a:lstStyle/>
    <a:p>
      <a:r>
        <a:rPr lang="en-US"/>
        <a:t>Hello World</a:t>
      </a:r>
    </a:p>
  </p:txBody>
</p:sp>
```

--------------------------------

### EG_TextBulletSize Group Definition (XSD)

Source: https://github.com/elliottcarlson/pptx-viewer/blob/gh-pages/docs/a_pPr.md

Defines the options for specifying bullet size. This includes following the text size (buSzTx), a percentage of text size (buSzPct), or a fixed point size (buSzPts).

```xml
<xsd:group name="EG_TextBulletSize">
  <xsd:choice>
    <xsd:element name="buSzTx" type="CT_TextBulletSizeFollowText"/>
    <xsd:element name="buSzPct" type="CT_TextBulletSizePercent"/>
    <xsd:element name="buSzPts" type="CT_TextBulletSizePoint"/>
  </xsd:choice>
</xsd:group>
```

--------------------------------

### p:sld Element Documentation

Source: https://github.com/elliottcarlson/pptx-viewer/blob/gh-pages/docs/p_sld.md

Provides a detailed breakdown of the p:sld element, including its purpose, namespace, parent/child elements, attributes, and schema definition.

```APIDOC
## p:sld Element

### Description

This element specifies the existence of a single shape. A shape can either be a preset or a custom geometry, defined using the DrawingML framework. In addition to a geometry each shape can have both visual and non-visual properties attached. Text and corresponding styling information can also be attached to a shape. This shape is specified along with all other shapes within either the shape tree or group shape elements.

### Element Information

**Namespace**: http://schemas.openxmlformats.org/presentationml/2006/main
**Type**: p:CT_Slide

### Parent Elements

Root element of PresentationML Slide part.

### Child Elements

- **p:cSld** (1..1) - p:CT_CommonSlideData - Common slide data for slides
- **a:clsMapOvr** (0..1) - a:CT_ColorMappingOverride - Color Scheme Map Override
- **p:transition** (0..1) - p:CT_SlideTransition - Slide Transition
- **p:timing** (0..1) - p:CT_SlideTiming - Slide Timing Information
- **p:extLst** (0..1) - p:CT_ExtensionListModify - Extension List with Mod Flag

### Attributes

- **showMasterSp** (0..1) - xsd:boolean - Show Master Shapes - Default: "true"
- **showMasterPhAnin** (0..1) - xsd:boolean - Show Master Placeholder Animations - Default: "true"
- **show** (0..1) - xsd:boolean - Show Slide in Slide Show - Default: "true"

### Schema

```xml
<xsd:complexType name="CT_Slide">
  <xsd:sequence>
    <xsd:element name="cSld"       type="CT_CommonSlideData"/>
    <xsd:element name="clrMapOvr"  type="a:CT_ColorMappingOverride" minOccurs="0"/>
    <xsd:element name="transition" type="CT_SlideTransition"        minOccurs="0"/>
    <xsd:element name="timing"     type="CT_SlideTiming"            minOccurs="0"/>
    <xsd:element name="extLst"     type="CT_ExtensionListModify"    minOccurs="0"/>
  </xsd:sequence>
  <xsd:attribute name="showMasterSp"     type="xsd:boolean" default="true"/>
  <xsd:attribute name="showMasterPhAnim" type="xsd:boolean" default="true"/>
  <xsd:attribute name="show"             type="xsd:boolean" default="true"/>
</xsd:complexType>
```

### References

- http://www.datypic.com/sc/ooxml/e-p_sld.html
- http://python-pptx.readthedocs.org/en/develop/dev/analysis/schema/ct_slide.html
- https://msdn.microsoft.com/en-us/library/documentformat.openxml.presentation.slide(v=office.15).aspx
```

--------------------------------

### a:chExt Element Documentation

Source: https://github.com/elliottcarlson/pptx-viewer/blob/gh-pages/docs/a_chExt.md

Provides detailed information about the a:chExt element, including its attributes, parent and child elements, and schema definition.

```APIDOC
## a:chExt Element

### Description

This element describes the length and width properties for how far a drawing element should extend for.

### Namespace

http://schemas.openxmlformats.org/drawingml/2006/main

### Type

a:CT_PositiveSize2D

### Parent Elements

- **a:xfrm** (a:CT_GroupTransform2D)

### Child Elements

*None*

### Attributes

- **cx** (a:ST_PositiveCoordinate) - Required - Extent Length
- **cy** (a:ST_PositiveCoordinate) - Required - Extent Width

### Schema

```xml
<xsd:complexType name="CT_PositiveSize2D">
  <xsd:attribute name="cx" type="ST_PositiveCoordinate" use="required"/>
  <xsd:attribute name="cy" type="ST_PositiveCoordinate" use="required"/>
</xsd:complexType>
```

### References

- http://www.datypic.com/sc/ooxml/e-a_chExt-1.html
- https://msdn.microsoft.com/en-us/library/office/documentformat.openxml.drawing.chartdrawing.extent.aspx
```

--------------------------------

### HSL Color Element Documentation

Source: https://github.com/elliottcarlson/pptx-viewer/blob/gh-pages/docs/a_hslClr.md

Provides detailed information about the &lt;a:hslClr&gt; element, used for specifying colors with the HSL model.

```APIDOC
## &lt;a:hslClr&gt;

### Description

This element specifies a color using the HSL color model. A perceptual gamma of 2.2 is assumed.

Hue refers to the dominant wavelength of color, saturation refers to the purity of its hue, and luminance refers to its lightness or darkness.

As with all colors, colors defined with the HSL color model can have color transforms applied to it.

### Namespace

http://schemas.openxmlformats.org/drawingml/2006/main

### Type

a:CT_HslColor

### Parent Elements

- a:alphaInv
- p:clrMru
- a:clrRepl
- a:custClr
- a:duotone
- a:fontRef
- a:glow
- a:gs
- a:innerShdw
- a:outerShdw
- a:prstShdw
- a:solidFill
- a:tcTxStyle
- a:lnRef
- a:fillRef
- a:effectRef
- p:bgRef
- draw-diag:fillClrLst
- draw-diag:linClrLst
- draw-diag:effectClrLst
- draw-diag:txLinClrLst
- draw-diag:txFillClrLst
- draw-diag:txEffectClrLst
- a:dk1
- a:lt1
- a:dk2
- a:lt2
- a:accent1
- a:accent2
- a:accent3
- a:accent4
- a:accent5
- a:accent6
- a:hlink
- a:folHlink
- a:extrusionClr
- a:contourClr
- a:clrFrom
- a:clrTo
- a:fgClr
- a:bgClr
- a:buClr
- a:highlight
- p:clrVal
- p:from
- p:to
- p:penClr

### Child Elements

#### Tint
- **Name**: a:tint
- **Occurs**: [0..*]
- **Type**: a:CT_PositiveFixedPercentage
- **Description**: Adjusts the color by adding white.

#### Shade
- **Name**: a:shade
- **Occurs**: [0..*]
- **Type**: a:CT_PositiveFixedPercentage
- **Description**: Adjusts the color by adding black.

#### Complement
- **Name**: a:comp
- **Occurs**: [0..*]
- **Type**: a:CT_ComplementTransform
- **Description**: Inverts the color.

#### Inverse
- **Name**: a:inv
- **Occurs**: [0..*]
- **Type**: a:CT_InverseTransform
- **Description**: Inverts the color.

#### Gray
- **Name**: a:gray
- **Occurs**: [0..*]
- **Type**: a:CT_GrayscaleTransform
- **Description**: Converts the color to grayscale.

#### Alpha
- **Name**: a:alpha
- **Occurs**: [0..*]
- **Type**: a:CT_PositiveFixedPercentage
- **Description**: Sets the alpha transparency value.

#### Alpha Offset
- **Name**: a:alphaOff
- **Occurs**: [0..*]
- **Type**: a:CT_FixedPercentage
- **Description**: Offsets the alpha transparency value.

#### Alpha Modulation
- **Name**: a:alphaMod
- **Occurs**: [0..*]
- **Type**: a:CT_PositivePercentage
- **Description**: Modulates the alpha transparency value.

#### Hue
- **Name**: a:hue
- **Occurs**: [0..*]
- **Type**: a:CT_PositiveFixedAngle
- **Description**: Adjusts the hue of the color.

#### Hue Offset
- **Name**: a:hueOff
- **Occurs**: [0..*]
- **Type**: a:CT_Angle
- **Description**: Offsets the hue of the color.

#### Hue Modulate
- **Name**: a:hueMod
- **Occurs**: [0..*]
- **Type**: a:CT_PositivePercentage
- **Description**: Modulates the hue of the color.

#### Saturation
- **Name**: a:sat
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Adjusts the saturation of the color.

#### Saturation Offset
- **Name**: a:satOff
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Offsets the saturation of the color.

#### Saturation Modulation
- **Name**: a:satMod
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Modulates the saturation of the color.

#### Luminance
- **Name**: a:lum
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Adjusts the luminance of the color.

#### Luminance Offset
- **Name**: a:lumOff
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Offsets the luminance of the color.

#### Luminance Modulation
- **Name**: a:lumMod
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Modulates the luminance of the color.

#### Red
- **Name**: a:red
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Adjusts the red component of the color.

#### Red Offset
- **Name**: a:redOff
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Offsets the red component of the color.

#### Red Modulation
- **Name**: a:redMod
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Modulates the red component of the color.

#### Green
- **Name**: a:green
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Adjusts the green component of the color.

#### Green Offset
- **Name**: a:greenOff
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Offsets the green component of the color.

#### Green Modulation
- **Name**: a:greenMod
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Modulates the green component of the color.

#### Blue
- **Name**: a:blue
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Adjusts the blue component of the color.

#### Blue Offset
- **Name**: a:blueOff
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Offsets the blue component of the color.

#### Blue Modulation
- **Name**: a:blueMod
- **Occurs**: [0..*]
- **Type**: a:CT_Percentage
- **Description**: Modulates the blue component of the color.

#### Gamma
- **Name**: a:gamma
- **Occurs**: [0..*]
- **Type**: a:CT_GammaTransform
- **Description**: Applies a gamma correction to the color.

#### Inverse Gamma
- **Name**: a:invGamma
- **Occurs**: [0..*]
- **Type**: a:CT_InverseGammaTransform
- **Description**: Applies an inverse gamma correction to the color.
```

--------------------------------

### a:ext Element

Source: https://github.com/elliottcarlson/pptx-viewer/blob/gh-pages/docs/a_ext.md

Documentation for the a:ext element which defines the length and width properties for how far a drawing element should extend.

```APIDOC
## a:ext Element

### Description

This element describes the length and width properties for how far a drawing element should extend.

### Method

N/A (Schema Element)

### Endpoint

N/A (Schema Element)

### Parameters

#### Attributes

- **cx** (a:ST_PositiveCoordinate) - Required - Extent Length
- **cy** (a:ST_PositiveCoordinate) - Required - Extent Width

### Request Example

```json
{
  "cx": "100000",
  "cy": "50000"
}
```

### Response

#### Success Response (N/A - Schema Element)

- **cx** (a:ST_PositiveCoordinate) - Extent Length
- **cy** (a:ST_PositiveCoordinate) - Extent Width

#### Response Example

```json
{
  "cx": "100000",
  "cy": "50000"
}
```

### Schema

```xml
<xsd:complexType name="CT_PositiveSize2D">
  <xsd:attribute name="cx" type="ST_PositiveCoordinate" use="required"/>
  <xsd:attribute name="cy" type="ST_PositiveCoordinate" use="required"/>
</xsd:complexType>
```
```

--------------------------------

### Text Run Element (<a:r>)

Source: https://github.com/elliottcarlson/pptx-viewer/blob/gh-pages/docs/a_r.md

Details about the Text Run element, its purpose, structure, and usage within Office Open XML documents.

```APIDOC
## Text Run Element (<a:r>)

### Description

This element specifies the presence of a run of text within the containing text body. The run element is the lowest level text separation mechanism within a text body. A text run can contain text run properties associated with the run. If no properties are listed then properties specified in the defRPr element are used.

### Namespace

http://schemas.openxmlformats.org/drawingml/2006/main

### Type

a:CT_RegularTextRun

### Parent Elements

- **a:p** (a:CT_TextParagraph)

### Child Elements

- **a:rPr** ([0..1]) - a:CT_TextCharacterProperties - Text Character Properties
- **a:t** ([1..1]) - xsd:string - Text String

### Attributes

*None*

### Schema

```xml
<xsd:complexType name="CT_RegularTextRun">
  <xsd:sequence>
    <xsd:element name="rPr" type="CT_TextCharacterProperties" minOccurs="0"/>
    <xsd:element name="t" type="xsd:string"/>
  </xsd:sequence>
</xsd:complexType>
```

### References

- http://www.datypic.com/sc/ooxml/e-a_r-1.html
- https://msdn.microsoft.com/en-us/library/office/documentformat.openxml.drawing.run.aspx
- http://python-pptx.readthedocs.org/en/develop/dev/analysis/schema/ct_textparagraph.html
```

--------------------------------

### a:srgbClr Element Documentation

Source: https://github.com/elliottcarlson/pptx-viewer/blob/gh-pages/docs/a_srgbClr.md

This section details the a:srgbClr element, used for specifying colors in the RGB hex format (RRGGBB). It includes its description, namespace, type, parent elements, child elements, and attributes.

```APIDOC
## a:srgbClr

### Description
This element specifies a color using the red, green, blue color model. Red, green, and blue is expressed as sequence of hex digits, RRGGBB. A perceptual gamma of 2.2 is used.

Specifies the level of red as expressed by a percentage offset increase or decrease relative to the input color.

### Namespace
http://schemas.openxmlformats.org/drawingml/2006/main

### Type
a:CT_SRgbColor

### Parent Elements
- a:EG_ColorChoice
- a:alphaInv (a:CT_AlphaInverseEffect)
- p:clrMru (a:CT_ColorMRU)
- a:clrRepl (a:CT_ColorReplaceEffect)
- a:custClr (a:CT_CustomColor)
- a:duotone (a:CT_DuotoneEffect)
- a:fontRef (a:CT_FontReference)
- a:glow (a:CT_GlowEffect)
- a:gs (a:CT_GradientStop)
- a:innerShdw (a:CT_InnerShadowEffect)
- a:outerShdw (a:CT_OuterShadowEffect)
- a:prstShdw (a:CT_PresetShadowEffect)
- a:solidFill (a:CT_SolidColorFillProperties)
- a:tcTxStyle (a:CT_TableStyleTextStyle)
- a:lnRef (a:CT_StyleMatrixReference)
- a:fillRef (a:CT_StyleMatrixReference)
- a:effectRef (a:CT_StyleMatrixReference)
- p:bgRef (a:CT_StyleMatrixReference)
- draw-diag:fillClrLst (draw-diag:CT_Colors)
- draw-diag:linClrLst (draw-diag:CT_Colors)
- draw-diag:effectClrLst (draw-diag:CT_Colors)
- draw-diag:txLinClrLst (draw-diag:CT_Colors)
- draw-diag:txFillClrLst (draw-diag:CT_Colors)
- draw-diag:txEffectClrLst (draw-diag:CT_Colors)
- a:dk1 (a:CT_Color)
- a:lt1 (a:CT_Color)
- a:dk2 (a:CT_Color)
- a:lt2 (a:CT_Color)
- a:accent1 (a:CT_Color)
- a:accent2 (a:CT_Color)
- a:accent3 (a:CT_Color)
- a:accent4 (a:CT_Color)
- a:accent5 (a:CT_Color)
- a:accent6 (a:CT_Color)
- a:hlink (a:CT_Color)
- a:folHlink (a:CT_Color)
- a:extrusionClr (a:CT_Color)
- a:contourClr (a:CT_Color)
- a:clrFrom (a:CT_Color)
- a:clrTo (a:CT_Color)
- a:fgClr (a:CT_Color)
- a:bgClr (a:CT_Color)
- a:buClr (a:CT_Color)
- a:highlight (a:CT_Color)
- p:clrVal (a:CT_Color)
- p:from (a:CT_Color)
- p:to (a:CT_Color)
- p:penClr (a:CT_Color)

### Child Elements
- **a:tint** (0..*) - a:CT_PositiveFixedPercentage - Tint
- **a:shade** (0..*) - a:CT_PositiveFixedPercentage - Shade
- **a:comp** (0..*) - a:CT_ComplementTransform - Complement
- **a:inv** (0..*) - a:CT_InverseTransform - Inverse
- **a:gray** (0..*) - a:CT_GrayscaleTransform - Gray
- **a:alpha** (0..*) - a:CT_PositiveFixedPercentage - Alpha
- **a:alphaOff** (0..*) - a:CT_FixedPercentage - Alpha Offset
- **a:alphaMod** (0..*) - a:CT_PositivePercentage - Alpha Modulation
- **a:hue** (0..*) - a:CT_PositiveFixedAngle - Hue
- **a:hueOff** (0..*) - a:CT_Angle - Hue Offset
- **a:hueMod** (0..*) - a:CT_PositivePercentage - Hue Modulate
- **a:sat** (0..*) - a:CT_Percentage - Saturation
- **a:satOff** (0..*) - a:CT_Percentage - Saturation Offset
- **a:satMod** (0..*) - a:CT_Percentage - Saturation Modulation
- **a:lum** (0..*) - a:CT_Percentage - Luminance
- **a:lumOff** (0..*) - a:CT_Percentage - Luminance Offset
- **a:lumMod** (0..*) - a:CT_Percentage - Luminance Modulation
- **a:red** (0..*) - a:CT_Percentage - Red
- **a:redOff** (0..*) - a:CT_Percentage - Red Offset
- **a:redMod** (0..*) - a:CT_Percentage - Red Modulation
- **a:green** (0..*) - a:CT_Percentage - Green
- **a:greenOff** (0..*) - a:CT_Percentage - Green Offset
- **a:greenMod** (0..*) - a:CT_Percentage - Green Modification
- **a:blue** (0..*) - a:CT_Percentage - Blue
- **a:blueOff** (0..*) - a:CT_Percentage - Blue Offset
- **a:blueMod** (0..*) - a:CT_Percentage - Blue Modification
- **a:gamma** (0..*) - a:CT_GammaTransform - Gamma
- **a:invGamma** (0..*) - a:CT_InverseGammaTransform - Inverse Gamma

### Attributes
- **val** (1..1) - a:ST_HexBinary3 - Value (Required)

### Request Example
```xml
<a:srgbClr val="RRGGBB"/>
```

### Response
#### Success Response (200)
- **val** (a:ST_HexBinary3) - The hex value representing the RGB color.
```