Programmer Guide/Command Reference/EVAL/pgitest - Revision history

Christian at 18:10, 21 April 2011

2011-04-21T18:10:01Z

← Older revision		Revision as of 20:10, 21 April 2011
Line 5:		Line 5:
	:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX<sub>scalar</sub></var>, <var>PY<sub>scalar</sub></var>)</code>		:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX<sub>scalar</sub></var>, <var>PY<sub>scalar</sub></var>)</code>
	:;<var>X</var>:a [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.		:;<var>X</var>:a [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.
	:;<var>IX</var>:The index of the polygon of ''X'' to be tested; 0 <= <var>IX</var> < <code>[[../pgget\|pgget]](''X'')</code>		:;<var>IX</var>:The index of the polygon of ''X'' to be tested; 0 ≤ <var>IX</var> < <code>[[../pgget\|pgget]](''X'')</code>
	:;<var>PX, PY</var>: The point ''P''=<''PX'',''PY''> to be tested.		:;<var>PX, PY</var>: The point ''P''=<''PX'',''PY''> to be tested.
	;Result 1: The result ''r'' is a scaler.		;Result 1: The result ''r'' is a scaler.
Line 41:		Line 41:
	:<code>pgitest(<var>X</var>, <var>IX</var>, <var>P</var>, <var>IP</var>)</code>		:<code>pgitest(<var>X</var>, <var>IX</var>, <var>P</var>, <var>IP</var>)</code>
	:;<var>P</var>:a [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.		:;<var>P</var>:a [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.
	:;<var>IP</var>:The index of the polygon of ''P'' to be tested; 0 <= <var>IP</var> < <code>[[../pgget\|pgget]](''P'')</code>)		:;<var>IP</var>:The index of the polygon of ''P'' to be tested; 0 ≤ <var>IP</var> < <code>[[../pgget\|pgget]](''P'')</code>)
	;Result 4: The result ''r'' is a scalar.		;Result 4: The result ''r'' is a scalar.
	::{\|class="keinrahmen"		::{\|class="keinrahmen"

193.171.195.48 at 10:31, 21 April 2011

2011-04-21T10:31:22Z

← Older revision		Revision as of 12:31, 21 April 2011
Line 28:		Line 28:
	;Usage 3:		;Usage 3:
	:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX1<sub>scalar</sub></var>, <var>PY1<sub>scalar</sub></var>), <var>PX2<sub>scalar</sub></var>, <var>PY2<sub>scalar</sub></var>)</code>		:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX1<sub>scalar</sub></var>, <var>PY1<sub>scalar</sub></var>), <var>PX2<sub>scalar</sub></var>, <var>PY2<sub>scalar</sub></var>)</code>

	:;<var>PX1, PY1, PX2, PY2</var>: The points <''PX1'',''PY1''> and <''PX2'',''PY2''> defining the line ''P'' to be tested.		:;<var>PX1, PY1, PX2, PY2</var>: The points <''PX1'',''PY1''> and <''PX2'',''PY2''> defining the line ''P'' to be tested.
	;Result 3: The result ''r'' is a scalar.		;Result 3: The result ''r'' is a scalar.
Line 55:		Line 54:
	----		----
	;See also: [[../pginit\|pginit]], [[../pgget\|pgget]], [[../pgiline\|pgiline]], [[../pgxgrid\|pgxgrid]], [[../pgsplit\|pgsplit]], [[../pgtrans\|pgtrans]], [[../pghull\|pghull]]		;See also: [[../pginit\|pginit]], [[../pgget\|pgget]], [[../pgiline\|pgiline]], [[../pgxgrid\|pgxgrid]], [[../pgsplit\|pgsplit]], [[../pgtrans\|pgtrans]], [[../pghull\|pghull]]


	[[../#Functions\|<function list>]]		[[../#Functions\|<function list>]]

193.171.195.48 at 08:46, 20 April 2011

2011-04-20T08:46:07Z

← Older revision		Revision as of 10:46, 20 April 2011
Line 5:		Line 5:
	:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX<sub>scalar</sub></var>, <var>PY<sub>scalar</sub></var>)</code>		:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX<sub>scalar</sub></var>, <var>PY<sub>scalar</sub></var>)</code>
	:;<var>X</var>:a [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.		:;<var>X</var>:a [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.
	:;<var>IX</var>:The index of the polygon of ''X'' to be tested; 0 <= <var>IX</var> < <code>[[../pgget\|pgget]](''X'')</code>)		:;<var>IX</var>:The index of the polygon of ''X'' to be tested; 0 <= <var>IX</var> < <code>[[../pgget\|pgget]](''X'')</code>
	:;<var>PX, PY</var>: The point ''P''=<''PX'',''PY''> to be tested.		:;<var>PX, PY</var>: The point ''P''=<''PX'',''PY''> to be tested.
	;Result 1: The result ''r'' is a scaler.		;Result 1: The result ''r'' is a scaler.

193.171.195.48 at 07:31, 20 April 2011

2011-04-20T07:31:25Z

← Older revision		Revision as of 09:31, 20 April 2011
Line 29:		Line 29:
	:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX1<sub>scalar</sub></var>, <var>PY1<sub>scalar</sub></var>), <var>PX2<sub>scalar</sub></var>, <var>PY2<sub>scalar</sub></var>)</code>		:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX1<sub>scalar</sub></var>, <var>PY1<sub>scalar</sub></var>), <var>PX2<sub>scalar</sub></var>, <var>PY2<sub>scalar</sub></var>)</code>

	:;<var>PX1, PY1, PX2, PY2</var>: The ~~start point~~ <''PX1'',''PY1''> and ~~the end point~~ <''PX2'',''PY2''> of the line ''P'' to be tested.		:;<var>PX1, PY1, PX2, PY2</var>: The points <''PX1'',''PY1''> and <''PX2'',''PY2''> defining the line ''P'' to be tested.
	;Result 3: The result ''r'' is a scalar.		;Result 3: The result ''r'' is a scalar.
	::{\|class="keinrahmen"		::{\|class="keinrahmen"

193.171.195.48 at 07:10, 20 April 2011

2011-04-20T07:10:42Z

← Older revision		Revision as of 09:10, 20 April 2011
Line 9:		Line 9:
	;Result 1: The result ''r'' is a scaler.		;Result 1: The result ''r'' is a scaler.
	::{\|class="keinrahmen"		::{\|class="keinrahmen"
	\|''r''='''0''' \|\| ... point ''P'' is outside the polygon		\|''r''='''0''' \|\| ... point ''P'' is outside the polygon ''X<sub>IX</sub>''
	\|-		\|-
	\|''r''='''1''' \|\| ... point ''P'' is inside the polygon		\|''r''='''1''' \|\| ... point ''P'' is inside the polygon ''X<sub>IX</sub>''
	\|}		\|}
	----		----
	;Usage 1:		;Usage 2:
	:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX<sub>scalar</sub></var>, <var>PY<sub>vector</sub></var>)</code>		:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX<sub>scalar</sub></var>, <var>PY<sub>vector</sub></var>)</code>
	:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX<sub>vector</sub></var>, <var>PY<sub>scalar</sub></var>)</code>		:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX<sub>vector</sub></var>, <var>PY<sub>scalar</sub></var>)</code>
	:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX<sub>vector</sub></var>, <var>PY<sub>vector</sub></var>)</code>		:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX<sub>vector</sub></var>, <var>PY<sub>vector</sub></var>)</code>
	:;<var>PX, PY</var>: The points ''P''[i]=<''PX''[i],''PY''[i]> to be tested. One of these arguments must be a vector.		:;<var>PX, PY</var>: The points ''P''[i]=<''PX''[i],''PY''[i]> to be tested. One of these arguments must be a vector.
	;Result 1: The result ''r'' is a vector containing the test result for each point ''P''[i].		;Result 2: The result ''r'' is a vector containing the test result for each point ''P''[i].
	::{\|class="keinrahmen"		::{\|class="keinrahmen"
	\|''r''[i]='''0''' \|\| ... point ''P''[i] is outside the polygon		\|''r''[i]='''0''' \|\| ... point ''P''[i] is outside the polygon ''X<sub>IX</sub>''
	\|-		\|-
	\|''r''[i]='''1''' \|\| ... point ''P''[i] is inside the polygon		\|''r''[i]='''1''' \|\| ... point ''P''[i] is inside the polygon ''X<sub>IX</sub>''
	\|}		\|}
			----
			;Usage 3:
			:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX1<sub>scalar</sub></var>, <var>PY1<sub>scalar</sub></var>), <var>PX2<sub>scalar</sub></var>, <var>PY2<sub>scalar</sub></var>)</code>

			:;<var>PX1, PY1, PX2, PY2</var>: The start point <''PX1'',''PY1''> and the end point <''PX2'',''PY2''> of the line ''P'' to be tested.
			;Result 3: The result ''r'' is a scalar.
	:;<var>X</var>:~~A [[~~..~~/#polygons~~\|~~closed point-list]] or a [[~~../~~#polygons~~\|~~polygon~~-~~stream]] defining one or more polygons.~~		::{\|class="keinrahmen"
	~~;Result~~ 1~~: The number of [[~~../~~#polygons~~\|~~simple polygons]]~~ ''N'' ~~stored in~~ ''X''. If the ~~result is~~ '''0'~~'',~~ ''X'' ~~contains no valid polygons.~~		\|''r''='''0''' \|\| ... the line ''P'' is outside the polygon ''X<sub>IX</sub>''
			\|-
			\|''r''='''1''' \|\| ... the line ''P'' is inside the polygon ''X<sub>IX</sub>''
			\|-
			\|''r''='''2''' \|\| ... the line ''P'' intersects the polygon ''X<sub>IX</sub>''
			\|}
	----		----
	;Usage 2:<code>~~pgget~~(<var>X</var>, <var>I</var>, <var>~~fmt~~</var>)</code>		;Usage 4:
	:;<var>X</var>:A [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.		:<code>pgitest(<var>X</var>, <var>IX</var>, <var>P</var>, <var>IP</var>)</code>
	:;<var>I</var>:The index of the polygon to be ~~returned~~; 0 <= <var>I</var> < ~~''N'' (=~~ <code>pgget(''X'')</code>)		:;<var>P</var>:a [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.
	:;~~<var>fmt</var>~~:The ~~format of the~~ result.:		:;<var>IP</var>:The index of the polygon of ''P'' to be tested; 0 <= <var>IP</var> < <code>[[../pgget\|pgget]](''P'')</code>)
			;Result 4: The result ''r'' is a scalar.
	::{\|class="keinrahmen"		::{\|class="keinrahmen"
	\|''~~fmt~~''=0 \|\|... ~~return~~ the ''I''~~-th~~ polygon of ''X'' ~~as [[~~../~~#polygons~~\|~~polygon~~-~~stream]]~~		\|''r''='''0''' \|\| ... the polygon ''P<sub>IP</sub>'' is outside the polygon ''X<sub>IX</sub>''
			\|-
			\|''r''='''1''' \|\| ... the polygon ''P<sub>IP</sub>'' is included in the polygon ''X<sub>IX</sub>''
			\|-
			\|''r''='''2''' \|\| ... the polygons ''P<sub>IP</sub>'' and ''X<sub>IX</sub>'' are partly overlapping
	\|-		\|-
	\|''~~fmt~~''=1 \|\|... ~~return~~ the ~~[[../#polygons\|~~polygon~~-stream]] header (a 8x2 matrix) of the~~ ''I''~~-th~~ polygon of ''X''		\|''r''='''3''' \|\| ... the polygon ''X<sub>IX</sub>'' is included in the polygon ''P<sub>IP</sub>''
	\|}		\|}
	~~;Result 2: The ''I''-th polygon stored in ''X'' in the format selected by ''fmt''.~~
	----		----
	;See also: [[../pginit\|pginit]], [[../~~pgitest~~\|~~pgitest~~]], [[../pgiline\|pgiline]], [[../pgxgrid\|pgxgrid]], [[../pgsplit\|pgsplit]], [[../pgtrans\|pgtrans]], [[../pghull\|pghull]]		;See also: [[../pginit\|pginit]], [[../pgget\|pgget]], [[../pgiline\|pgiline]], [[../pgxgrid\|pgxgrid]], [[../pgsplit\|pgsplit]], [[../pgtrans\|pgtrans]], [[../pghull\|pghull]]


	[[../#Functions\|<function list>]]		[[../#Functions\|<function list>]]

193.171.195.48 at 06:54, 20 April 2011

2011-04-20T06:54:29Z

@@ Line 12: / Line 12: @@
 |-
 |''r''='''1''' || ... point ''P'' is inside the polygon
 |}

193.171.195.48 at 06:49, 20 April 2011

2011-04-20T06:49:59Z

← Older revision		Revision as of 08:49, 20 April 2011
Line 5:		Line 5:
	:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX<sub>scalar</sub></var>, <var>PY<sub>scalar</sub></var>)</code>		:<code>pgitest(<var>X</var>, <var>IX</var>, <var>PX<sub>scalar</sub></var>, <var>PY<sub>scalar</sub></var>)</code>
	:;<var>X</var>:a [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.		:;<var>X</var>:a [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.
	:;<var>IX</var>:The index of the polygon of ''X'' to be tested; 0 <= <var>IX</var> < ~~''N'' (=~~ <code>[[../pgget\|pgget]](''X'')</code>)		:;<var>IX</var>:The index of the polygon of ''X'' to be tested; 0 <= <var>IX</var> < <code>[[../pgget\|pgget]](''X'')</code>)
	:;<var>PX, PY</var>: The point ''P''=<''PX'',''PY''> to be tested.		:;<var>PX, PY</var>: The point ''P''=<''PX'',''PY''> to be tested.
	;Result 1: The result ''r'' is a scaler.		;Result 1: The result ''r'' is a scaler.

193.171.195.48 at 06:49, 20 April 2011

2011-04-20T06:49:22Z

← Older revision		Revision as of 08:49, 20 April 2011
Line 8:		Line 8:
	:;<var>PX, PY</var>: The point ''P''=<''PX'',''PY''> to be tested.		:;<var>PX, PY</var>: The point ''P''=<''PX'',''PY''> to be tested.
	;Result 1: The result ''r'' is a scaler.		;Result 1: The result ''r'' is a scaler.
	:{\|class="keinrahmen"		::{\|class="keinrahmen"
	\|''r''='''0''' \|\| ... point ''P'' is outside the polygon		\|''r''='''0''' \|\| ... point ''P'' is outside the polygon
	\|-		\|-

193.171.195.48 at 06:49, 20 April 2011

2011-04-20T06:49:10Z

← Older revision		Revision as of 08:49, 20 April 2011
Line 9:		Line 9:
	;Result 1: The result ''r'' is a scaler.		;Result 1: The result ''r'' is a scaler.
	:{\|class="keinrahmen"		:{\|class="keinrahmen"
	\|''r''='''0''' \|\| ... point ''P'' is outside the polygon \|\|-		\|''r''='''0''' \|\| ... point ''P'' is outside the polygon
			\|-
	\|''r''='''1''' \|\| ... point ''P'' is inside the polygon		\|''r''='''1''' \|\| ... point ''P'' is inside the polygon
	\|}		\|}

193.171.195.48 at 06:48, 20 April 2011

2011-04-20T06:48:59Z

← Older revision		Revision as of 08:48, 20 April 2011
Line 9:		Line 9:
	;Result 1: The result ''r'' is a scaler.		;Result 1: The result ''r'' is a scaler.
	:{\|class="keinrahmen"		:{\|class="keinrahmen"
	\|''r''='''0''' \| ... point ''P'' is outside the polygon \|-		\|''r''='''0''' \|\| ... point ''P'' is outside the polygon \|\|-
	\|''r''='''1''' \| ... point ''P'' is inside the polygon		\|''r''='''1''' \|\| ... point ''P'' is inside the polygon
	\|}		\|}