| 
463 | 463 |               Positions at a path  | 
464 | 464 |             </title>  | 
465 | 465 |             <para>  | 
466 |  | -              <application>pgSphere</application> provides two functions to  | 
 | 466 | +              <application>pgSphere</application> provides three functions to  | 
467 | 467 |               get points at a path.  | 
468 | 468 |             </para>  | 
469 | 469 |             <funcsynopsis>  | 
 | 
477 | 477 |                   <paramdef>spath  <parameter>path</parameter></paramdef>  | 
478 | 478 |                   <paramdef>float8 <parameter>f</parameter></paramdef>  | 
479 | 479 |               </funcprototype>  | 
 | 480 | +              <funcprototype>  | 
 | 481 | +                <funcdef><function>spath_as_array</function></funcdef>  | 
 | 482 | +                  <paramdef>spath  <parameter>path</parameter></paramdef>  | 
 | 483 | +              </funcprototype>  | 
480 | 484 |             </funcsynopsis>  | 
481 | 485 |             <para>  | 
482 | 486 |                The first function returns the <parameter>i</parameter>-th  | 
 | 
495 | 499 | <![CDATA[  spoint]]>  | 
496 | 500 | <![CDATA[------------]]>  | 
497 | 501 | <![CDATA[ (15d , 0d)]]>  | 
 | 502 | +<![CDATA[(1 row)]]>  | 
 | 503 | +              </programlisting>  | 
 | 504 | +            </example>  | 
 | 505 | +            <example>  | 
 | 506 | +              <title>  | 
 | 507 | +                Get i-th point of a path  | 
 | 508 | +              </title>  | 
 | 509 | +              <programlisting>  | 
 | 510 | +<![CDATA[sql> SELECT spoint( spath '{(0, 0),(1, 1)}', 1 );]]>  | 
 | 511 | +<![CDATA[   spoint  ]]>  | 
 | 512 | +<![CDATA[------------]]>  | 
 | 513 | +<![CDATA[  (0 , 0) ]]>  | 
 | 514 | +<![CDATA[(1 row)]]>  | 
 | 515 | +<![CDATA[]]>  | 
 | 516 | +<![CDATA[sql> SELECT spoint( spath '{(0, 0),(1, 1)}', 2 );]]>  | 
 | 517 | +<![CDATA[   spoint  ]]>  | 
 | 518 | +<![CDATA[------------]]>  | 
 | 519 | +<![CDATA[  (1 , 1) ]]>  | 
 | 520 | +<![CDATA[(1 row)]]>  | 
 | 521 | +              </programlisting>  | 
 | 522 | +            </example>  | 
 | 523 | +            <example>  | 
 | 524 | +              <title>  | 
 | 525 | +                Get array representation of points  | 
 | 526 | +              </title>  | 
 | 527 | +              <programlisting>  | 
 | 528 | +<![CDATA[sql> SELECT spath_as_array( spath '{(0, 0),(1, 1)}');]]>  | 
 | 529 | +<![CDATA[    spath_as_array     ]]>  | 
 | 530 | +<![CDATA[-----------------------]]>  | 
 | 531 | +<![CDATA[ {"(0 , 0)","(1 , 1)"}]]>  | 
498 | 532 | <![CDATA[(1 row)]]>  | 
499 | 533 |               </programlisting>  | 
500 | 534 |             </example>  | 
 | 
532 | 566 |             </example>  | 
533 | 567 | 
 
  | 
534 | 568 |           </sect3>  | 
535 |  | -              | 
 | 569 | +          <sect3 id="funcs.spoly.pos">  | 
 | 570 | +            <title>  | 
 | 571 | +              Positions at a polygon  | 
 | 572 | +            </title>  | 
 | 573 | +            <para>  | 
 | 574 | +              <application>pgSphere</application> provides two functions to  | 
 | 575 | +              get points at a path.  | 
 | 576 | +            </para>  | 
 | 577 | +            <funcsynopsis>  | 
 | 578 | +              <funcprototype>  | 
 | 579 | +                <funcdef><function>spoint</function></funcdef>  | 
 | 580 | +                  <paramdef>spoly <parameter>path</parameter></paramdef>  | 
 | 581 | +                  <paramdef>int4 <parameter>i</parameter></paramdef>  | 
 | 582 | +              </funcprototype>  | 
 | 583 | +              <funcprototype>  | 
 | 584 | +                <funcdef><function>spoly_as_array</function></funcdef>  | 
 | 585 | +                  <paramdef>spath  <parameter>path</parameter></paramdef>  | 
 | 586 | +              </funcprototype>  | 
 | 587 | +              </funcsynopsis>  | 
 | 588 | +              <example>  | 
 | 589 | +              <title>Get by index</title>  | 
 | 590 | +              <programlisting>  | 
 | 591 | +<![CDATA[sql> SELECT  spoint( spoly '{(0,0),(1,0),(1,1)}', 1 );]]>  | 
 | 592 | +<![CDATA[ spoint  ]]>  | 
 | 593 | +<![CDATA[---------]]>  | 
 | 594 | +<![CDATA[ (0 , 0)]]>  | 
 | 595 | +<![CDATA[ (1 row)]]>  | 
 | 596 | +<![CDATA[]]>  | 
 | 597 | +<![CDATA[sql> SELECT  spoint( spoly '{(0,0),(1,0),(1,1)}', 2 );]]>  | 
 | 598 | +<![CDATA[ spoint  ]]>  | 
 | 599 | +<![CDATA[---------]]>  | 
 | 600 | +<![CDATA[ (1 , 0)]]>  | 
 | 601 | +<![CDATA[ (1 row)]]>  | 
 | 602 | +<![CDATA[]]>  | 
 | 603 | +<![CDATA[sql> SELECT  spoint( spoly '{(0,0),(1,0),(1,1)}', 3 );]]>  | 
 | 604 | +<![CDATA[ spoint  ]]>  | 
 | 605 | +<![CDATA[---------]]>  | 
 | 606 | +<![CDATA[ (1 , 1)]]>  | 
 | 607 | +<![CDATA[ (1 row)]]>  | 
 | 608 | +              </programlisting>  | 
 | 609 | +            </example>  | 
 | 610 | +                          <example>  | 
 | 611 | +              <title>Represent points as array</title>  | 
 | 612 | +              <programlisting>  | 
 | 613 | +<![CDATA[sql> SELECT  spoly_as_array( spoly '{(0,0),(1,0),(1,1)}' );]]>  | 
 | 614 | +<![CDATA[         spoly_as_array          ]]>  | 
 | 615 | +<![CDATA[---------------------------------]]>  | 
 | 616 | +<![CDATA[ {"(0 , 0)","(1 , 0)","(1 , 1)"}]]>  | 
 | 617 | +<![CDATA[(1 row)]]>  | 
 | 618 | +              </programlisting>  | 
 | 619 | +            </example>  | 
 | 620 | +            </sect3>  | 
536 | 621 |         </sect2>  | 
537 | 622 | 
 
  | 
538 | 623 |         <sect2 id="funcs.sbox">  | 
 | 
0 commit comments