o 7h '@sXdZddlmZddlmZddlmZddlmZddl m Z m Z GdddeZ 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 lazypropertyc@seZdZdZddZeddZejddZeddZejd dZd d Z ed d Z e jdd Z eddZ e jddZ ddZ e ddZeddZeddZddZddZddZd d!Zd"S)# 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. cC||||||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_idxr]/var/www/html/figdemos/bartoux_crm/venv/lib/python3.10/site-packages/pptx/shapes/connector.py begin_connects zConnector.begin_connectcC4|j}|j|j|j}}}|r||n|}t|S)z Return the X-position of the begin point of this connector, in English Metric Units (as a |Length| object). _elementxcxflipHr)rcxnSprrrbegin_xrrrr-zConnector.begin_xc C|j}|j|j|jt|f\}}}}|rA||}t||}||kr)|||_dS||kr4|||_dSd|_||_|||_dSt||}||krU||_|||_dS||krc||_|||_dSd|_|||_|||_dSNFTrrrrintabs) rvaluerrrrnew_xold_xdxrrrr8,   cCr)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_yrrrr+UrzConnector.begin_yc Crrrr(r)r*r r!) rr"rr(r)r*new_yold_ydyrrrr+`r&cCr )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_cxnr rrr end_connect}s zConnector.end_connectcC4|j}|j|j|j}}}|r|n||}t|S)z Return the X-position of the end point of this connector, in English Metric Units (as a |Length| object). r)rrrrrend_xrrrr4rzConnector.end_xc C|j}|j|j|jt|f\}}}}|rEt||}||kr(||_|||_dS||kr6||_|||_dSd|_|||_|||_dS||}t||}||krZ|||_dS||kre|||_dSd|_||_|||_dSrr) rr"rrrrr#r%r$rrrr4,   cCr3)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_yrrrr7rzConnector.end_yc Cr5rr,) rr"rr(r)r*r-r/r.rrrr7r6cCs |jjS)z'Helper method required by |LineFormat|.)rspPr get_or_add_lnrrrrr9s zConnector.get_or_add_lncCst|S)z|LineFormat| instance for this connector. Provides access to line properties such as line color, width, and line style. rr:rrrlineszConnector.linecCs |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. )rr8lnr:rrrr<s z Connector.lncCstjS)zMember of `MSO_SHAPE_TYPE` identifying the type of this shape. Unconditionally `MSO_SHAPE_TYPE.LINE` for a `Connector` object. )rLINEr:rrr shape_typeszConnector.shape_typecC$|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)rrrrAstCxnrrrr   zConnector._connect_begin_tocCr?)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)rr@rAget_or_add_endCxnrCrDrE)rrrrAendCxnrrrr0rGzConnector._connect_end_tocC|j|j|j|jf\}}}}t||d|f|t||dft||d||f||t||dfd|\|_|_dS)z Move the begin point of this connector to coordinates of the connection point of *shape* specified by *cxn_pt_idx*. rrKN)lefttopwidthheightr rr+rrrrr(rr)rrrr zConnector._move_begin_to_cxncCrJ)z Move the end point of this connector to the coordinates of the connection point of *shape* specified by *cxn_pt_idx*. rKrLN)rOrPrQrRr r4r7rSrrrr1rTzConnector._move_end_to_cxnN)__name__ __module__ __qualname____doc__rpropertyrsetterr+r2r4r7r9rr;r<r>r r0r r1rrrrr s>             r N) rX __future__r pptx.dml.linerpptx.enum.shapesrpptx.shapes.baser pptx.utilrrr rrrrs