hi 'fdZddlmZddlmZddlmZddlmZddl m Z m Z GddeZ d S) 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 lazypropertycVeZdZdZdZedZejdZedZejdZdZ edZ e jd Z ed Z e jd Z d Z e d ZedZedZdZdZdZdZdS) 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. c^||||||dS)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 m/var/www/development/aibuddy-work/election-extract/venv/lib/python3.11/site-packages/pptx/shapes/connector.py begin_connectzConnector.begin_connects6$ uj111 z22222cj|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-<  w%+u2!(!b&&q7||rc|j}|j|j|jt |f\}}}}|rU||z}t ||z }||kr ||z|_dS||kr ||z |_dSd|_||_||z |_dSt ||z }||kr||_||z|_dS||kr||_||z |_dSd|_||z|_||z |_dSNFTrrrrintabs) rvaluerrrrnew_xold_xdxs rrzConnector.begin_x8  #guxc%jjH2ue  #FEUU]##B~~7r7# 7UQYBzz7r7" b&7rcj|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\}}}}|rU||z}t ||z }||kr ||z|_dS||kr ||z |_dSd|_||_||z |_dSt ||z }||kr||_||z|_dS||kr||_||z |_dSd|_||z|_||z |_dSr rr+r,r-r"r#) rr$rr+r,r-new_yold_ydys rr.zConnector.begin_y`r(rc^||||||dS)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}s6 UJ/// eZ00000rcj|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<  w%+u2&B5zzrc|j}|j|j|jt |f\}}}}|rat ||z }||kr||_||z|_dS||kr||_||z |_dSd|_||z|_||z |_dS||z}t ||z }||kr ||z|_dS||kr ||z |_dSd|_||_||z |_dSr r!) rr$rrrrr%r'r&s rr9zConnector.end_x  #guxc%jjH2ue  #UQYBzz7r7# b&7FEUU]##B~~7r7" 7rcj|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\}}}}|rat ||z }||kr||_||z|_dS||kr||_||z |_dSd|_||z|_||z |_dS||z}t ||z }||kr ||z|_dS||kr ||z |_dSd|_||_||z |_dSr r0) rr$rr+r,r-r1r3r2s rr>zConnector.end_yr<rc>|jjS)z'Helper method required by |LineFormat|.)rspPr get_or_add_lnrs rrBzConnector.get_or_add_lns}!//111rc t|S)z|LineFormat| instance for this connector. Provides access to line properties such as line color, width, and line style. rrCs rlinezConnector.lines$rc$|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}!$$rctjS)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 ""rcv|jjj}|}|j|_||_dS)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_tos6 ],7 ++--> rcv|jjj}|}|j|_||_dS)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_tos6 ],7 --//N  rc ,|j|j|j|jf\}}}}t ||dz z|f|t ||dz zft ||dz z||zf||zt ||dz zfd|\|_|_dS)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 z59ek5<G 1b"AQJ#3q26z??#AQJR(BAQJ( & &  &" dlllrc ,|j|j|j|jf\}}}}t ||dz z|f|t ||dz zft ||dz z||zf||zt ||dz zfd|\|_|_dS)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 z59ek5<G 1b"AQJ#3q26z??#AQJR(BAQJ( " "  " DJJJrN)__name__ __module__ __qualname____doc__rpropertyrsetterr.r7r9r>rBr rErGrJr r5rr6rrr r s333*X ^##^#8X ^##^#8111 X \##\#8X \##\#8222  \ %%X%##X#               rr N) rd __future__r pptx.dml.linerpptx.enum.shapesrpptx.shapes.baser pptx.utilrr r rgrrrms#"""""$$$$$$++++++&&&&&&''''''''YYYYY YYYYYr