j '^dZddlmZddlmZddlmZddlmZddl m Z m Z GddeZ y ) zConnector (line) shape and related objects. A connector is a line shape having end-points that can be connected to other objects (but not to other connectors). A connector can be straight, have elbows, or can be curved. ) annotations LineFormat)MSO_SHAPE_TYPE) BaseShape)Emu lazypropertyc:eZdZdZdZedZejdZedZejdZdZ edZ e jd Z ed Z e jd Z d Z e d ZedZedZdZdZdZdZy) ConnectorzConnector (line) shape. A connector is a linear shape having end-points that can be connected to other objects (but not to other connectors). A connector can be straight, have elbows, or can be curved. cL|j|||j||y)a **EXPERIMENTAL** - *The current implementation only works properly with rectangular shapes, such as pictures and rectangles. Use with other shape types may cause unexpected visual alignment of the connected end-point and could lead to a load error if cxn_pt_idx exceeds the connection point count available on the connected shape. That said, a quick test should reveal what to expect when using this method with other shape types.* Connect the beginning of this connector to *shape* at the connection point specified by *cxn_pt_idx*. Each shape has zero or more connection points and they are identified by index, starting with 0. Generally, the first connection point of a shape is at the top center of its bounding box and numbering proceeds counter-clockwise from there. However this is only a convention and may vary, especially with non built-in shapes. N)_connect_begin_to_move_begin_to_cxnselfshape cxn_pt_idxs V/root/aria/tools/markitdown-venv/lib/python3.12/site-packages/pptx/shapes/connector.py begin_connectzConnector.begin_connects$$ uj1 z2c|j}|j|j|j}}}|r||zn|}t |S)z Return the X-position of the begin point of this connector, in English Metric Units (as a |Length| object). _elementxcxflipHr)rcxnSprrrbegin_xs rrzConnector.begin_x-=  ww%++u2!!b&q7|rc|j}|j|j|jt |f\}}}}|rL||z}t ||z }||k\r ||z|_y||kr ||z |_yd|_||_||z |_yt ||z }||kr||_||z|_y||kr||_||z |_yd|_||z|_||z |_yNFTrrrrintabs) rvaluerrrrnew_xold_xdxs rrzConnector.begin_x8 #gguxxc%jH2ue FEUU]#B~7r7# 7UQYBz7r7" b&7rc|j}|j|j|j}}}|r||zn|}t |S)z Return the Y-position of the begin point of this connector, in English Metric Units (as a |Length| object). rycyflipVr)rrr+r,r-begin_ys rr.zConnector.begin_yUrrc|j}|j|j|jt |f\}}}}|rL||z}t ||z }||k\r ||z|_y||kr ||z |_yd|_||_||z |_yt ||z }||kr||_||z|_y||kr||_||z |_yd|_||z|_||z |_yr rr+r,r-r"r#) rr$rr+r,r-new_yold_ydys rr.zConnector.begin_y`r(rcL|j|||j||y)ae **EXPERIMENTAL** - *The current implementation only works properly with rectangular shapes, such as pictures and rectangles. Use with other shape types may cause unexpected visual alignment of the connected end-point and could lead to a load error if cxn_pt_idx exceeds the connection point count available on the connected shape. That said, a quick test should reveal what to expect when using this method with other shape types.* Connect the ending of this connector to *shape* at the connection point specified by *cxn_pt_idx*. N)_connect_end_to_move_end_to_cxnrs r end_connectzConnector.end_connect}s$ UJ/ eZ0rc|j}|j|j|j}}}|r|n||z}t |S)z Return the X-position of the end point of this connector, in English Metric Units (as a |Length| object). r)rrrrrend_xs rr9zConnector.end_x=  ww%++u2B5zrc|j}|j|j|jt |f\}}}}|rXt ||z }||kr||_||z|_y||kr||_||z |_yd|_||z|_||z |_y||z}t ||z }||k\r ||z|_y||kr ||z |_yd|_||_||z |_yr r!) rr$rrrrr%r'r&s rr9zConnector.end_x #gguxxc%jH2ue UQYBz7r7# b&7FEUU]#B~7r7" 7rc|j}|j|j|j}}}|r|n||z}t |S)z Return the Y-position of the end point of this connector, in English Metric Units (as a |Length| object). r*)rrr+r,r-end_ys rr>zConnector.end_yr:rc|j}|j|j|jt |f\}}}}|rXt ||z }||kr||_||z|_y||kr||_||z |_yd|_||z|_||z |_y||z}t ||z }||k\r ||z|_y||kr ||z |_yd|_||_||z |_yr r0) rr$rr+r,r-r1r3r2s rr>zConnector.end_yr<rcJ|jjjS)z'Helper method required by |LineFormat|.)rspPr get_or_add_lnrs rrBzConnector.get_or_add_lns}}!!//11rct|S)z|LineFormat| instance for this connector. Provides access to line properties such as line color, width, and line style. rrCs rlinezConnector.lines$rcB|jjjS)zHelper method required by |LineFormat|. The ```` element containing the line format properties such as line color and width. |None| if no `` element is present. )rrAlnrCs rrGz Connector.lns}}!!$$$rc"tjS)zMember of `MSO_SHAPE_TYPE` identifying the type of this shape. Unconditionally `MSO_SHAPE_TYPE.LINE` for a `Connector` object. )rLINErCs r shape_typezConnector.shape_types """rc|jjj}|j}|j|_||_y)z Add or update a stCxn element for this connector that connects its begin point to the connection point of *shape* specified by *cxn_pt_idx*. N)r nvCxnSpPr cNvCxnSpPrget_or_add_stCxnshape_idididx)rrrrMstCxns rr zConnector._connect_begin_tos9 ]],,77 ++->> rc|jjj}|j}|j|_||_y)z Add or update an endCxn element for this connector that connects its end point to the connection point of *shape* specified by *cxn_pt_idx*. N)rrLrMget_or_add_endCxnrOrPrQ)rrrrMendCxns rr5zConnector._connect_end_tos9 ]],,77 --/NN  rc ,|j|j|j|jf\}}}}t ||dz z|f|t ||dz zft ||dz z||zf||zt ||dz zfd|\|_|_y)z Move the begin point of this connector to coordinates of the connection point of *shape* specified by *cxn_pt_idx*. rrWN)lefttopwidthheightr"rr.rrrrr+rr,s rrzConnector._move_begin_to_cxns zz599ekk5<<G 1b"AQJ#3q26z?#AQJR(BAQJ( &  &" dlrc ,|j|j|j|jf\}}}}t ||dz z|f|t ||dz zft ||dz z||zf||zt ||dz zfd|\|_|_y)z Move the end point of this connector to the coordinates of the connection point of *shape* specified by *cxn_pt_idx*. rWrXN)r[r\r]r^r"r9r>r_s rr6zConnector._move_end_to_cxns zz599ekk5<<G 1b"AQJ#3q26z?#AQJR(BAQJ( "  " DJrN)__name__ __module__ __qualname____doc__rpropertyrsetterr.r7r9r>rBr rErGrJr r5rr6rrr r s3* ^^##8 ^^##81  \\##8 \\##82  %%##     rr N) rd __future__r pptx.dml.linerpptx.enum.shapesrpptx.shapes.baser pptx.utilrr r rgrrrms)#$+&'Y Yr