[{"data":1,"prerenderedAt":887},["ShallowReactive",2],{"navigation_docs_en":3,"-en-docx-media":237,"-en-docx-media-surround":882},[4,23,61,91,163],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":22},"Getting Started","i-lucide-rocket","\u002Fen\u002Fgetting-started","en\u002F01.getting-started",[10,14,18],{"title":11,"path":12,"stem":13},"Introduction","\u002Fen\u002Fgetting-started\u002Fintroduction","en\u002F01.getting-started\u002F01.introduction",{"title":15,"path":16,"stem":17},"Installation","\u002Fen\u002Fgetting-started\u002Finstallation","en\u002F01.getting-started\u002F02.installation",{"title":19,"path":20,"stem":21},"AI Integration","\u002Fen\u002Fgetting-started\u002Fai-integration","en\u002F01.getting-started\u002F03.ai-integration",false,{"title":24,"icon":25,"path":26,"stem":27,"children":28,"page":22},"CORE","i-lucide-box","\u002Fen\u002Fcore","en\u002F02.core",[29,33,37,41,45,49,53,57],{"title":30,"path":31,"stem":32},"@office-open\u002Fcore","\u002Fen\u002Fcore\u002Foverview","en\u002F02.core\u002F01.overview",{"title":34,"path":35,"stem":36},"XML Components","\u002Fen\u002Fcore\u002Fxml-components","en\u002F02.core\u002F02.xml-components",{"title":38,"path":39,"stem":40},"Values and Validation","\u002Fen\u002Fcore\u002Fvalues","en\u002F02.core\u002F03.values",{"title":42,"path":43,"stem":44},"Unit Converters","\u002Fen\u002Fcore\u002Fconverters","en\u002F02.core\u002F04.converters",{"title":46,"path":47,"stem":48},"Formatter","\u002Fen\u002Fcore\u002Fformatter","en\u002F02.core\u002F05.formatter",{"title":50,"path":51,"stem":52},"Parser","\u002Fen\u002Fcore\u002Fparser","en\u002F02.core\u002F06.parser",{"title":54,"path":55,"stem":56},"Archive","\u002Fen\u002Fcore\u002Farchive","en\u002F02.core\u002F07.archive",{"title":58,"path":59,"stem":60},"Charts","\u002Fen\u002Fcore\u002Fcharts","en\u002F02.core\u002F08.charts",{"title":62,"icon":63,"path":64,"stem":65,"children":66,"page":22},"XML","i-lucide-code-xml","\u002Fen\u002Fxml","en\u002F03.xml",[67,71,75,79,83,87],{"title":68,"path":69,"stem":70},"@office-open\u002Fxml","\u002Fen\u002Fxml\u002Foverview","en\u002F03.xml\u002F01.overview",{"title":72,"path":73,"stem":74},"Parsing","\u002Fen\u002Fxml\u002Fparsing","en\u002F03.xml\u002F02.parsing",{"title":76,"path":77,"stem":78},"Serialization","\u002Fen\u002Fxml\u002Fserialization","en\u002F03.xml\u002F03.serialization",{"title":80,"path":81,"stem":82},"Query Utilities","\u002Fen\u002Fxml\u002Fquery-utilities","en\u002F03.xml\u002F04.query-utilities",{"title":84,"path":85,"stem":86},"XML Escape","\u002Fen\u002Fxml\u002Fescape","en\u002F03.xml\u002F05.escape",{"title":88,"path":89,"stem":90},"Type Reference","\u002Fen\u002Fxml\u002Ftypes","en\u002F03.xml\u002F06.types",{"title":92,"icon":93,"path":94,"stem":95,"children":96,"page":22},"DOCX","i-lucide-file-text","\u002Fen\u002Fdocx","en\u002F04.docx",[97,101,105,109,113,117,120,124,128,132,136,140,144,148,152,156,160],{"title":98,"path":99,"stem":100},"@office-open\u002Fdocx","\u002Fen\u002Fdocx\u002Foverview","en\u002F04.docx\u002F01.overview",{"title":102,"path":103,"stem":104},"Quick Start","\u002Fen\u002Fdocx\u002Fquickstart","en\u002F04.docx\u002F02.quickstart",{"title":106,"path":107,"stem":108},"Text and Paragraphs","\u002Fen\u002Fdocx\u002Ftext-and-paragraphs","en\u002F04.docx\u002F03.text-and-paragraphs",{"title":110,"path":111,"stem":112},"Tables","\u002Fen\u002Fdocx\u002Ftables","en\u002F04.docx\u002F04.tables",{"title":114,"path":115,"stem":116},"Images","\u002Fen\u002Fdocx\u002Fimages","en\u002F04.docx\u002F05.images",{"title":58,"path":118,"stem":119},"\u002Fen\u002Fdocx\u002Fcharts","en\u002F04.docx\u002F06.charts",{"title":121,"path":122,"stem":123},"SmartArt","\u002Fen\u002Fdocx\u002Fsmartart","en\u002F04.docx\u002F07.smartart",{"title":125,"path":126,"stem":127},"Media","\u002Fen\u002Fdocx\u002Fmedia","en\u002F04.docx\u002F08.media",{"title":129,"path":130,"stem":131},"Links","\u002Fen\u002Fdocx\u002Flinks","en\u002F04.docx\u002F09.links",{"title":133,"path":134,"stem":135},"Headers and Footers","\u002Fen\u002Fdocx\u002Fheaders-and-footers","en\u002F04.docx\u002F10.headers-and-footers",{"title":137,"path":138,"stem":139},"Equations and Symbols","\u002Fen\u002Fdocx\u002Fequations-and-symbols","en\u002F04.docx\u002F11.equations-and-symbols",{"title":141,"path":142,"stem":143},"Styles and Themes","\u002Fen\u002Fdocx\u002Fstyles-and-themes","en\u002F04.docx\u002F12.styles-and-themes",{"title":145,"path":146,"stem":147},"Page Layout","\u002Fen\u002Fdocx\u002Fpage-layout","en\u002F04.docx\u002F13.page-layout",{"title":149,"path":150,"stem":151},"References","\u002Fen\u002Fdocx\u002Freferences","en\u002F04.docx\u002F14.references",{"title":153,"path":154,"stem":155},"Comments and Revisions","\u002Fen\u002Fdocx\u002Fcomments-and-revisions","en\u002F04.docx\u002F15.comments-and-revisions",{"title":157,"path":158,"stem":159},"Export","\u002Fen\u002Fdocx\u002Fexport","en\u002F04.docx\u002F16.export",{"title":72,"path":161,"stem":162},"\u002Fen\u002Fdocx\u002Fparsing","en\u002F04.docx\u002F17.parsing",{"title":164,"icon":165,"path":166,"stem":167,"children":168,"page":22},"PPTX","i-lucide-presentation","\u002Fen\u002Fpptx","en\u002F05.pptx",[169,173,176,180,183,186,189,192,195,198,201,204,208,211,215,219,223,227,230,233],{"title":170,"path":171,"stem":172},"@office-open\u002Fpptx","\u002Fen\u002Fpptx\u002Foverview","en\u002F05.pptx\u002F01.overview",{"title":102,"path":174,"stem":175},"\u002Fen\u002Fpptx\u002Fquickstart","en\u002F05.pptx\u002F02.quickstart",{"title":177,"path":178,"stem":179},"Shapes and Text","\u002Fen\u002Fpptx\u002Fshapes-and-text","en\u002F05.pptx\u002F03.shapes-and-text",{"title":110,"path":181,"stem":182},"\u002Fen\u002Fpptx\u002Ftables","en\u002F05.pptx\u002F04.tables",{"title":114,"path":184,"stem":185},"\u002Fen\u002Fpptx\u002Fimages","en\u002F05.pptx\u002F05.images",{"title":58,"path":187,"stem":188},"\u002Fen\u002Fpptx\u002Fcharts","en\u002F05.pptx\u002F06.charts",{"title":121,"path":190,"stem":191},"\u002Fen\u002Fpptx\u002Fsmartart","en\u002F05.pptx\u002F07.smartart",{"title":125,"path":193,"stem":194},"\u002Fen\u002Fpptx\u002Fmedia","en\u002F05.pptx\u002F08.media",{"title":129,"path":196,"stem":197},"\u002Fen\u002Fpptx\u002Flinks","en\u002F05.pptx\u002F09.links",{"title":133,"path":199,"stem":200},"\u002Fen\u002Fpptx\u002Fheaders-and-footers","en\u002F05.pptx\u002F10.headers-and-footers",{"title":137,"path":202,"stem":203},"\u002Fen\u002Fpptx\u002Fequations-and-symbols","en\u002F05.pptx\u002F11.equations-and-symbols",{"title":205,"path":206,"stem":207},"Lines and Connectors","\u002Fen\u002Fpptx\u002Flines-and-connectors","en\u002F05.pptx\u002F12.lines-and-connectors",{"title":141,"path":209,"stem":210},"\u002Fen\u002Fpptx\u002Fstyles-and-themes","en\u002F05.pptx\u002F13.styles-and-themes",{"title":212,"path":213,"stem":214},"Effects and Fills","\u002Fen\u002Fpptx\u002Feffects-and-fills","en\u002F05.pptx\u002F14.effects-and-fills",{"title":216,"path":217,"stem":218},"Slide Layout","\u002Fen\u002Fpptx\u002Fslide-layout","en\u002F05.pptx\u002F15.slide-layout",{"title":220,"path":221,"stem":222},"Transitions","\u002Fen\u002Fpptx\u002Ftransitions","en\u002F05.pptx\u002F16.transitions",{"title":224,"path":225,"stem":226},"Animations","\u002Fen\u002Fpptx\u002Fanimations","en\u002F05.pptx\u002F17.animations",{"title":157,"path":228,"stem":229},"\u002Fen\u002Fpptx\u002Fexport","en\u002F05.pptx\u002F18.export",{"title":72,"path":231,"stem":232},"\u002Fen\u002Fpptx\u002Fparsing","en\u002F05.pptx\u002F19.parsing",{"title":234,"path":235,"stem":236},"Comments","\u002Fen\u002Fpptx\u002Fcomments","en\u002F05.pptx\u002F20.comments",{"id":238,"title":125,"body":239,"description":876,"extension":877,"links":878,"meta":879,"navigation":377,"path":126,"seo":880,"stem":127,"__hash__":881},"docs_en\u002Fen\u002F04.docx\u002F08.media.md",{"type":240,"value":241,"toc":869},"minimark",[242,251,256,315,319,322,511,515,518,531,535,646,650,653,865],[243,244,245,246,250],"p",{},"Word documents can embed various media types. This package provides support for images through ",[247,248,249],"code",{},"ImageRun",", which is the primary media type used in DOCX files.",[252,253,255],"h2",{"id":254},"supported-media-types","Supported Media Types",[257,258,259,275],"table",{},[260,261,262],"thead",{},[263,264,265,269,272],"tr",{},[266,267,268],"th",{},"Type",[266,270,271],{},"Format",[266,273,274],{},"Component",[276,277,278,291,303],"tbody",{},[263,279,280,284,287],{},[281,282,283],"td",{},"Raster images",[281,285,286],{},"JPG, PNG, GIF, BMP, TIF, ICO",[281,288,289],{},[247,290,249],{},[263,292,293,296,299],{},[281,294,295],{},"Vector images",[281,297,298],{},"SVG (with fallback)",[281,300,301],{},[247,302,249],{},[263,304,305,308,311],{},[281,306,307],{},"EMF\u002FWMF",[281,309,310],{},"EMF, WMF",[281,312,313],{},[247,314,249],{},[252,316,318],{"id":317},"image-insertion","Image Insertion",[243,320,321],{},"Images are the most commonly embedded media.",[323,324,329],"pre",{"className":325,"code":326,"language":327,"meta":328,"style":328},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { Paragraph, ImageRun } from \"@office-open\u002Fdocx\";\n\nnew Paragraph({\n    children: [\n        new ImageRun({\n            type: \"png\",\n            data: imageBuffer,\n            transformation: { width: 200, height: 150 },\n        }),\n    ],\n});\n","ts","",[247,330,331,372,379,394,407,419,437,450,482,493,501],{"__ignoreMap":328},[332,333,336,340,344,348,351,354,357,360,363,366,369],"span",{"class":334,"line":335},"line",1,[332,337,339],{"class":338},"s7zQu","import",[332,341,343],{"class":342},"sMK4o"," {",[332,345,347],{"class":346},"sTEyZ"," Paragraph",[332,349,350],{"class":342},",",[332,352,353],{"class":346}," ImageRun",[332,355,356],{"class":342}," }",[332,358,359],{"class":338}," from",[332,361,362],{"class":342}," \"",[332,364,98],{"class":365},"sfazB",[332,367,368],{"class":342},"\"",[332,370,371],{"class":342},";\n",[332,373,375],{"class":334,"line":374},2,[332,376,378],{"emptyLinePlaceholder":377},true,"\n",[332,380,382,385,388,391],{"class":334,"line":381},3,[332,383,384],{"class":342},"new",[332,386,347],{"class":387},"s2Zo4",[332,389,390],{"class":346},"(",[332,392,393],{"class":342},"{\n",[332,395,397,401,404],{"class":334,"line":396},4,[332,398,400],{"class":399},"swJcz","    children",[332,402,403],{"class":342},":",[332,405,406],{"class":346}," [\n",[332,408,410,413,415,417],{"class":334,"line":409},5,[332,411,412],{"class":342},"        new",[332,414,353],{"class":387},[332,416,390],{"class":346},[332,418,393],{"class":342},[332,420,422,425,427,429,432,434],{"class":334,"line":421},6,[332,423,424],{"class":399},"            type",[332,426,403],{"class":342},[332,428,362],{"class":342},[332,430,431],{"class":365},"png",[332,433,368],{"class":342},[332,435,436],{"class":342},",\n",[332,438,440,443,445,448],{"class":334,"line":439},7,[332,441,442],{"class":399},"            data",[332,444,403],{"class":342},[332,446,447],{"class":346}," imageBuffer",[332,449,436],{"class":342},[332,451,453,456,458,460,463,465,469,471,474,476,479],{"class":334,"line":452},8,[332,454,455],{"class":399},"            transformation",[332,457,403],{"class":342},[332,459,343],{"class":342},[332,461,462],{"class":399}," width",[332,464,403],{"class":342},[332,466,468],{"class":467},"sbssI"," 200",[332,470,350],{"class":342},[332,472,473],{"class":399}," height",[332,475,403],{"class":342},[332,477,478],{"class":467}," 150",[332,480,481],{"class":342}," },\n",[332,483,485,488,491],{"class":334,"line":484},9,[332,486,487],{"class":342},"        }",[332,489,490],{"class":346},")",[332,492,436],{"class":342},[332,494,496,499],{"class":334,"line":495},10,[332,497,498],{"class":346},"    ]",[332,500,436],{"class":342},[332,502,504,507,509],{"class":334,"line":503},11,[332,505,506],{"class":342},"}",[332,508,490],{"class":346},[332,510,371],{"class":342},[252,512,514],{"id":513},"video-and-audio","Video and Audio",[243,516,517],{},"The OOXML specification supports embedded video and audio through media relationships, but playback depends on the application opening the document. For complex media embedding scenarios, consider:",[519,520,521,528],"ul",{},[522,523,524,525,527],"li",{},"Using the ",[247,526,125],{}," class for managing media relationships",[522,529,530],{},"Embedding video thumbnails as images with hyperlinks to online video URLs",[252,532,534],{"id":533},"imagerun-options","ImageRun Options",[257,536,537,549],{},[260,538,539],{},[263,540,541,544,546],{},[266,542,543],{},"Option",[266,545,268],{},[266,547,548],{},"Description",[276,550,551,582,597,615,629],{},[263,552,553,558,563],{},[281,554,555],{},[247,556,557],{},"type",[281,559,560],{},[247,561,562],{},"string",[281,564,565,566,569,570,569,573,569,576,569,579,490],{},"Image format (",[247,567,568],{},"\"png\"",", ",[247,571,572],{},"\"jpg\"",[247,574,575],{},"\"gif\"",[247,577,578],{},"\"bmp\"",[247,580,581],{},"\"svg\"",[263,583,584,589,594],{},[281,585,586],{},[247,587,588],{},"data",[281,590,591],{},[247,592,593],{},"Buffer | Uint8Array | string",[281,595,596],{},"Image data (buffer or base64)",[263,598,599,604,609],{},[281,600,601],{},[247,602,603],{},"transformation",[281,605,606],{},[247,607,608],{},"object",[281,610,611,614],{},[247,612,613],{},"{ width, height }"," in pixels",[263,616,617,622,626],{},[281,618,619],{},[247,620,621],{},"floating",[281,623,624],{},[247,625,608],{},[281,627,628],{},"Floating positioning (anchor or inline)",[263,630,631,636,640],{},[281,632,633],{},[247,634,635],{},"altText",[281,637,638],{},[247,639,608],{},[281,641,642,645],{},[247,643,644],{},"{ title, description }"," for accessibility",[252,647,649],{"id":648},"floating-images","Floating Images",[243,651,652],{},"Position images freely on the page using floating mode:",[323,654,656],{"className":325,"code":655,"language":327,"meta":328,"style":328},"new Paragraph({\n    children: [\n        new ImageRun({\n            type: \"png\",\n            data: imageBuffer,\n            transformation: { width: 200, height: 150 },\n            floating: {\n                horizontalPosition: { relative: \"page\", align: \"center\" },\n                verticalPosition: { relative: \"page\", offset: 1440 },\n                wrap: { type: \"none\" },\n            },\n        }),\n    ],\n});\n",[247,657,658,668,676,686,700,710,734,744,781,812,835,840,849,856],{"__ignoreMap":328},[332,659,660,662,664,666],{"class":334,"line":335},[332,661,384],{"class":342},[332,663,347],{"class":387},[332,665,390],{"class":346},[332,667,393],{"class":342},[332,669,670,672,674],{"class":334,"line":374},[332,671,400],{"class":399},[332,673,403],{"class":342},[332,675,406],{"class":346},[332,677,678,680,682,684],{"class":334,"line":381},[332,679,412],{"class":342},[332,681,353],{"class":387},[332,683,390],{"class":346},[332,685,393],{"class":342},[332,687,688,690,692,694,696,698],{"class":334,"line":396},[332,689,424],{"class":399},[332,691,403],{"class":342},[332,693,362],{"class":342},[332,695,431],{"class":365},[332,697,368],{"class":342},[332,699,436],{"class":342},[332,701,702,704,706,708],{"class":334,"line":409},[332,703,442],{"class":399},[332,705,403],{"class":342},[332,707,447],{"class":346},[332,709,436],{"class":342},[332,711,712,714,716,718,720,722,724,726,728,730,732],{"class":334,"line":421},[332,713,455],{"class":399},[332,715,403],{"class":342},[332,717,343],{"class":342},[332,719,462],{"class":399},[332,721,403],{"class":342},[332,723,468],{"class":467},[332,725,350],{"class":342},[332,727,473],{"class":399},[332,729,403],{"class":342},[332,731,478],{"class":467},[332,733,481],{"class":342},[332,735,736,739,741],{"class":334,"line":439},[332,737,738],{"class":399},"            floating",[332,740,403],{"class":342},[332,742,743],{"class":342}," {\n",[332,745,746,749,751,753,756,758,760,763,765,767,770,772,774,777,779],{"class":334,"line":452},[332,747,748],{"class":399},"                horizontalPosition",[332,750,403],{"class":342},[332,752,343],{"class":342},[332,754,755],{"class":399}," relative",[332,757,403],{"class":342},[332,759,362],{"class":342},[332,761,762],{"class":365},"page",[332,764,368],{"class":342},[332,766,350],{"class":342},[332,768,769],{"class":399}," align",[332,771,403],{"class":342},[332,773,362],{"class":342},[332,775,776],{"class":365},"center",[332,778,368],{"class":342},[332,780,481],{"class":342},[332,782,783,786,788,790,792,794,796,798,800,802,805,807,810],{"class":334,"line":484},[332,784,785],{"class":399},"                verticalPosition",[332,787,403],{"class":342},[332,789,343],{"class":342},[332,791,755],{"class":399},[332,793,403],{"class":342},[332,795,362],{"class":342},[332,797,762],{"class":365},[332,799,368],{"class":342},[332,801,350],{"class":342},[332,803,804],{"class":399}," offset",[332,806,403],{"class":342},[332,808,809],{"class":467}," 1440",[332,811,481],{"class":342},[332,813,814,817,819,821,824,826,828,831,833],{"class":334,"line":495},[332,815,816],{"class":399},"                wrap",[332,818,403],{"class":342},[332,820,343],{"class":342},[332,822,823],{"class":399}," type",[332,825,403],{"class":342},[332,827,362],{"class":342},[332,829,830],{"class":365},"none",[332,832,368],{"class":342},[332,834,481],{"class":342},[332,836,837],{"class":334,"line":503},[332,838,839],{"class":342},"            },\n",[332,841,843,845,847],{"class":334,"line":842},12,[332,844,487],{"class":342},[332,846,490],{"class":346},[332,848,436],{"class":342},[332,850,852,854],{"class":334,"line":851},13,[332,853,498],{"class":346},[332,855,436],{"class":342},[332,857,859,861,863],{"class":334,"line":858},14,[332,860,506],{"class":342},[332,862,490],{"class":346},[332,864,371],{"class":342},[866,867,868],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":328,"searchDepth":374,"depth":374,"links":870},[871,872,873,874,875],{"id":254,"depth":374,"text":255},{"id":317,"depth":374,"text":318},{"id":513,"depth":374,"text":514},{"id":533,"depth":374,"text":534},{"id":648,"depth":374,"text":649},"Embedded media support in Word documents","md",null,{},{"title":125,"description":876},"EOKHR01p498kzMLQsF4biaGQ6ONmkJ8nNCIjwFw-iXQ",[883,885],{"title":121,"path":122,"stem":123,"description":884,"children":-1},"Create SmartArt graphics with built-in layouts and data models",{"title":129,"path":130,"stem":131,"description":886,"children":-1},"External hyperlinks, bookmarks, and cross-references in Word documents",1778862995765]