[{"data":1,"prerenderedAt":451},["ShallowReactive",2],{"docs:\u002Fgetting-started":3},{"id":4,"title":5,"body":6,"description":442,"extension":443,"meta":444,"navigation":446,"path":447,"seo":448,"stem":449,"__hash__":450},"docs\u002Fgetting-started\u002Findex.md","Getting started",{"type":7,"value":8,"toc":436},"minimark",[9,14,18,23,31,55,61,75,78,99,116,120,123,350,357,374,378,381,419,423,432],[10,11,13],"h1",{"id":12},"getting-started","Getting Started",[15,16,17],"p",{},"This section covers the first workflow: install pyDreamplet, create an SVG\ncanvas, draw a shape, and save the result.",[19,20,22],"h2",{"id":21},"installation","Installation",[15,24,25,26,30],{},"Install the core package with ",[27,28,29],"code",{},"uv",":",[32,33,38],"pre",{"className":34,"code":35,"language":36,"meta":37,"style":37},"language-bash shiki shiki-themes material-theme-lighter github-light-high-contrast github-dark","uv add pydreamplet\n","bash","",[27,39,40],{"__ignoreMap":37},[41,42,45,48,52],"span",{"class":43,"line":44},"line",1,[41,46,29],{"class":47},"sp6cl",[41,49,51],{"class":50},"s_jvP"," add",[41,53,54],{"class":50}," pydreamplet\n",[15,56,57,58,30],{},"Or with ",[27,59,60],{},"pip",[32,62,64],{"className":34,"code":63,"language":36,"meta":37,"style":37},"pip install pydreamplet\n",[27,65,66],{"__ignoreMap":37},[41,67,68,70,73],{"class":43,"line":44},[41,69,60],{"class":47},[41,71,72],{"class":50}," install",[41,74,54],{"class":50},[15,76,77],{},"For notebook display support, install the optional notebook extra:",[32,79,81],{"className":34,"code":80,"language":36,"meta":37,"style":37},"uv add \"pydreamplet[notebook]\"\n",[27,82,83],{"__ignoreMap":37},[41,84,85,87,89,93,96],{"class":43,"line":44},[41,86,29],{"class":47},[41,88,51],{"class":50},[41,90,92],{"class":91},"sqo_7"," \"",[41,94,95],{"class":50},"pydreamplet[notebook]",[41,97,98],{"class":91},"\"\n",[32,100,102],{"className":34,"code":101,"language":36,"meta":37,"style":37},"pip install \"pydreamplet[notebook]\"\n",[27,103,104],{"__ignoreMap":37},[41,105,106,108,110,112,114],{"class":43,"line":44},[41,107,60],{"class":47},[41,109,72],{"class":50},[41,111,92],{"class":91},[41,113,95],{"class":50},[41,115,98],{"class":91},[19,117,119],{"id":118},"your-first-svg","Your First SVG",[15,121,122],{},"Create a canvas, append a shape, then save the SVG file:",[32,124,128],{"className":125,"code":126,"language":127,"meta":37,"style":37},"language-python shiki shiki-themes material-theme-lighter github-light-high-contrast github-dark","import pydreamplet as dp\n\nsvg = dp.SVG(300, 300)\n\ncircle = dp.Circle(\n    cx=150,\n    cy=150,\n    r=90,\n    fill=\"#14b8a6\",\n    stroke=\"#0f172a\",\n    stroke_width=4,\n)\n\nsvg.append(circle)\nsvg.save(\"example.svg\")\n","python",[27,129,130,146,153,190,195,213,228,240,253,271,288,301,306,311,329],{"__ignoreMap":37},[41,131,132,136,140,143],{"class":43,"line":44},[41,133,135],{"class":134},"sED7I","import",[41,137,139],{"class":138},"soTeR"," pydreamplet ",[41,141,142],{"class":134},"as",[41,144,145],{"class":138}," dp\n",[41,147,149],{"class":43,"line":148},2,[41,150,152],{"emptyLinePlaceholder":151},true,"\n",[41,154,156,159,163,166,170,174,177,181,184,187],{"class":43,"line":155},3,[41,157,158],{"class":138},"svg ",[41,160,162],{"class":161},"sWKEy","=",[41,164,165],{"class":138}," dp",[41,167,169],{"class":168},"sVsmf",".",[41,171,173],{"class":172},"sAK04","SVG",[41,175,176],{"class":168},"(",[41,178,180],{"class":179},"sNpir","300",[41,182,183],{"class":168},",",[41,185,186],{"class":179}," 300",[41,188,189],{"class":168},")\n",[41,191,193],{"class":43,"line":192},4,[41,194,152],{"emptyLinePlaceholder":151},[41,196,198,201,203,205,207,210],{"class":43,"line":197},5,[41,199,200],{"class":138},"circle ",[41,202,162],{"class":161},[41,204,165],{"class":138},[41,206,169],{"class":168},[41,208,209],{"class":172},"Circle",[41,211,212],{"class":168},"(\n",[41,214,216,220,222,225],{"class":43,"line":215},6,[41,217,219],{"class":218},"sYEV4","    cx",[41,221,162],{"class":161},[41,223,224],{"class":179},"150",[41,226,227],{"class":168},",\n",[41,229,231,234,236,238],{"class":43,"line":230},7,[41,232,233],{"class":218},"    cy",[41,235,162],{"class":161},[41,237,224],{"class":179},[41,239,227],{"class":168},[41,241,243,246,248,251],{"class":43,"line":242},8,[41,244,245],{"class":218},"    r",[41,247,162],{"class":161},[41,249,250],{"class":179},"90",[41,252,227],{"class":168},[41,254,256,259,261,264,267,269],{"class":43,"line":255},9,[41,257,258],{"class":218},"    fill",[41,260,162],{"class":161},[41,262,263],{"class":91},"\"",[41,265,266],{"class":50},"#14b8a6",[41,268,263],{"class":91},[41,270,227],{"class":168},[41,272,274,277,279,281,284,286],{"class":43,"line":273},10,[41,275,276],{"class":218},"    stroke",[41,278,162],{"class":161},[41,280,263],{"class":91},[41,282,283],{"class":50},"#0f172a",[41,285,263],{"class":91},[41,287,227],{"class":168},[41,289,291,294,296,299],{"class":43,"line":290},11,[41,292,293],{"class":218},"    stroke_width",[41,295,162],{"class":161},[41,297,298],{"class":179},"4",[41,300,227],{"class":168},[41,302,304],{"class":43,"line":303},12,[41,305,189],{"class":168},[41,307,309],{"class":43,"line":308},13,[41,310,152],{"emptyLinePlaceholder":151},[41,312,314,317,319,322,324,327],{"class":43,"line":313},14,[41,315,316],{"class":138},"svg",[41,318,169],{"class":168},[41,320,321],{"class":172},"append",[41,323,176],{"class":168},[41,325,326],{"class":172},"circle",[41,328,189],{"class":168},[41,330,332,334,336,339,341,343,346,348],{"class":43,"line":331},15,[41,333,316],{"class":138},[41,335,169],{"class":168},[41,337,338],{"class":172},"save",[41,340,176],{"class":168},[41,342,263],{"class":91},[41,344,345],{"class":50},"example.svg",[41,347,263],{"class":91},[41,349,189],{"class":168},[15,351,352,353,356],{},"In a notebook, use ",[27,354,355],{},"display()"," to render the result inline:",[32,358,360],{"className":125,"code":359,"language":127,"meta":37,"style":37},"svg.display()\n",[27,361,362],{"__ignoreMap":37},[41,363,364,366,368,371],{"class":43,"line":44},[41,365,316],{"class":138},[41,367,169],{"class":168},[41,369,370],{"class":172},"display",[41,372,373],{"class":168},"()\n",[19,375,377],{"id":376},"core-ideas","Core Ideas",[15,379,380],{},"pyDreamplet mirrors the structure of SVG. You create elements, configure their\nattributes, append them to a parent, and export the result.",[382,383,384,390,410,416],"ul",{},[385,386,387,389],"li",{},[27,388,173],{}," is the root canvas.",[385,391,392,393,395,396,395,399,395,402,405,406,409],{},"Shape classes such as ",[27,394,209],{},", ",[27,397,398],{},"Rect",[27,400,401],{},"Line",[27,403,404],{},"Path",", and ",[27,407,408],{},"Text"," map to SVG\nelements.",[385,411,412,415],{},[27,413,414],{},"G"," groups elements and lets you move or transform them together.",[385,417,418],{},"Scales and generators help turn data into visual geometry.",[19,420,422],{"id":421},"next","Next",[15,424,425,426,431],{},"Continue with ",[427,428,430],"a",{"href":429},"\u002Fdrawing-basics","Drawing basics"," for canvas size, coordinates,\ncommon shapes, styling, display, and saving.",[433,434,435],"style",{},"html pre.shiki code .sp6cl, html code.shiki .sp6cl{--shiki-light:#E2931D;--shiki-default:#702C00;--shiki-dark:#B392F0}html pre.shiki code .s_jvP, html code.shiki .s_jvP{--shiki-light:#91B859;--shiki-default:#032563;--shiki-dark:#9ECBFF}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);}html pre.shiki code .sqo_7, html code.shiki .sqo_7{--shiki-light:#39ADB5;--shiki-default:#032563;--shiki-dark:#9ECBFF}html pre.shiki code .sED7I, html code.shiki .sED7I{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#A0111F;--shiki-default-font-style:inherit;--shiki-dark:#F97583;--shiki-dark-font-style:inherit}html pre.shiki code .soTeR, html code.shiki .soTeR{--shiki-light:#90A4AE;--shiki-default:#0E1116;--shiki-dark:#E1E4E8}html pre.shiki code .sWKEy, html code.shiki .sWKEy{--shiki-light:#39ADB5;--shiki-default:#A0111F;--shiki-dark:#F97583}html pre.shiki code .sVsmf, html code.shiki .sVsmf{--shiki-light:#39ADB5;--shiki-default:#0E1116;--shiki-dark:#E1E4E8}html pre.shiki code .sAK04, html code.shiki .sAK04{--shiki-light:#6182B8;--shiki-default:#0E1116;--shiki-dark:#E1E4E8}html pre.shiki code .sNpir, html code.shiki .sNpir{--shiki-light:#F76D47;--shiki-default:#023B95;--shiki-dark:#79B8FF}html pre.shiki code .sYEV4, html code.shiki .sYEV4{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#702C00;--shiki-default-font-style:inherit;--shiki-dark:#FFAB70;--shiki-dark-font-style:inherit}",{"title":37,"searchDepth":155,"depth":155,"links":437},[438,439,440,441],{"id":21,"depth":148,"text":22},{"id":118,"depth":148,"text":119},{"id":376,"depth":148,"text":377},{"id":421,"depth":148,"text":422},"Install pyDreamplet and create your first SVG.","md",{"category":445},"guide",{"title":5},"\u002Fgetting-started",{"title":5,"description":442},"getting-started\u002Findex","SrjMSDn_inMHuJDgzi0VVaae7vW7veQpY_UUh7Q3HZQ",1780692544194]