개요

Graphics 컴포넌트에 경로를 표시할 때 사용되는 오브젝트입니다.

지원 환경

- 스크립트로 동적생성하여 사용할 수 있으며 넥사크로 스튜디오에서 디자인 할 수 없습니다.

- GraphicsPath 오브젝트는 한 개의 경로만 표시할 수 있습니다.
   연속되지 않는 경로를 표시하려면 한 개 이상의 GraphicsPath 오브젝트를 사용하여야 합니다.

- GraphicsPath 에서 moveTo() 메소드는 한번만 적용됩니다.

속성

fillstyle

GraphicsPath 의 내부영역에 채워질 형식과 색을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GraphicsStock.fillstyle[= strFillStyle]

문법 설정

strFillStyle ::= <color> | <linear-gradient>

<color> ::= <NamedColor> | <NumericColor>

<linear-gradient> ::= 'linear-gradient(' [<angle> , ] <color-stop> ')'
<angle> ::= 'to left' | 'to right' | 'to top' | 'to bottom' | 'to left top' | 'to left bottom' | 'to right top' | 'to right bottom'
<color-stop> ::= <startcolor-stop> [',' <listcolor-stop>] ',' <endcolor-stop>
<startcolor-stop> ::= <color> [<percentage>'%']
<listcolor-stop> ::= <color> [<percentage>'%'] [',' <listcolor-stop>]*
<endcolor-stop> ::= <color> [<percentage>'%']

var objGObject = new nexacro.GraphicsPath();

objGObject.fillstyle = "red";
objGObject.fillstyle = "rgb(255,255,0)";
objGObject.fillstyle = "#ffffaa";
objGObject.fillstyle = "linear-gradient(red, yellow)";
objGObject.fillstyle = "linear-gradient(to right, red, yellow)";
objGObject.fillstyle = "linear-gradient(to right, red 50%, yellow)";
objGObject.fillstyle = "linear-gradient(red, yellow 25%, green 50%, blue 75%, indigo)";
objGObject.fillstyle = "linear-gradient(to right, red, orange, yellow, green, blue, indigo, violet)";

참고

- GraphicsPaths, GraphicsPath 는 닫힌 경로가 존재할 경우에만 내부영역을 처리합니다.

id

GraphicsPath 의 고유 식별자를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GraphicsPath.id

문법 설정

var objGraphicsPath = new nexacro.GraphicsPath();

this.Graphics00.addChild( "GraphicsPath00", objGraphicsPath );

참고

-  addChild() 나 insertChild() 메소드를 사용하여 GraphicsPath 를 등록할때 오브젝트를 구별하기 위한 고유값입니다.

- 속성명이나 메소드명과 같은 예약어를 설정할 경우 오류가 발생할 수 있습니다.

miterlimit

strokejoin 속성값이 "miter" 일 때 특정 조건에서 "bevel" 로 변경적용될 비율값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GraphicsStock.miterlimit[= nLimit]

문법 설정

var objGObject = new nexacro.GraphicsPath();

objGObject.miterlimit = 1;

참고

- miterlimit 속성값을 설정하지 않으면 10 으로 적용됩니다.

- 일반적으로 miterlimit 속성값이 "miter_length / (stroke_width / 2)" 의 값보다 작으면 strokejoin 속성값이 "bevel" 로 적용됩니다.
   > miter_length : 두 선의 중심이 만나는 점에서 테두리가 만나 뾰족하게 돌출된 끝점까지의 거리
   > stroke_width : 선의 두께

opacity

GraphicsPath 영역의 투명도를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GraphicsStock.opacity[= nOpacity]

문법 설정

var objGraphicsPath = new nexacro.GraphicsPath() ;

objGraphicsPath.opacity = 0.5;
objGraphicsPath.opacity = "0.5";
objGraphicsPath.opacity = "50%";

참고

- opacity 속성값을 설정하지 않으면 undefined 가 설정되고 1 로 동작합니다.

- GraphicsGroup 의 경우 하위 오브젝트에 투명도가 동일하게 적용됩니다.

- 부모와 자식 오브젝트에 각각 opacity 속성이 설정되어 있으면 자식 오브젝트의 투명도는 부모의 투명도에 추가적으로 적용됩니다.
   예를 들어 부모의 opacity 값이 0.5 이고 자식의 opacity 값이 0.4 이면 결과적으로 자식 오브젝트는 0.2 의 투명도가 적용됩니다.

parent

GraphicsPath 의 부모 오브젝트를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

GraphicsPath.parent

참고

- 일반적으로 addChild() 메소드를 사용하여 GraphicsPath 를 추가한 오브젝트가 parent 속성에 설정됩니다.

- GraphicsPath 가 어디에도 속해있지 않거나 부모 오브젝트로부터 제거되면 null 값을 갖습니다.

strokecap

GraphicsPath 에 표시되는 경로의 양 끝 모양을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GraphicsPath.strokecap[= enumCap]

문법 설정

enumCap ::= 'butt' | 'round' | 'square'

var objGPath = new nexacro.GraphicsPath();  

objGPath.strokepen = "10px solid red"; 
objGPath.strokejoin = "bevel"; 
objGPath.strokecap = "square";

참고

- strokecap 속성값을 설정하지 않으면 "butt" 로 적용됩니다.

- strokecap 속성은 경로의 시작점과 끝점 모양을 결정하며 연결점의 모양은 strokejoin 속성으로 설정합니다.

- GraphicsPath 에 닫힌 경로가 설정되어 있을 경우 strokecap 속성은 적용되지 않습니다.

strokejoin

GraphicsPath 에 표시되는 경로의 연결점 모양을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GraphicsPath.strokejoin[= enumJoin]

문법 설정

enumJoin ::= 'miter' | 'round' | 'bevel'

var objGPath = new nexacro.GraphicsPath();  

objGPath.strokepen = "10px solid red"; 
objGPath.strokejoin = "bevel";

참고

- strokejoin 속성값을 설정하지 않으면 "miter" 로 적용됩니다.

- strokejoin 속성은 연결점의 모양을 결정하며 경로의 시작점과 끝점 모양은 strokecap 속성으로 설정합니다.

strokepen

GraphicsPath 에 표시되는 경로의 색과 형식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GraphicsPath.strokepen[= strStrokePen]

문법 설정

strStrokePen ::= <line-width> <line-style> <color>

<line-width> ::= <nWidth> ['px']
<line-style> ::= 'solid' | 'dotted' | 'dashed'
<color> ::= <NamedColor> | <NumericColor>

var objGPath = new nexacro.GraphicsPath();  

objGPath.strokepen = "5px solid red"; 
objGPath.strokepen = "5 dotted #999999"; 
objGPath.strokepen = "5px dotted rgb(255,0,0)";

참고

- strokepen 속성값을 설정하지 않으면 GraphicsPath 에 경로가 표시되지 않습니다.

- strokepen 속성값은 오브젝트의 실제 영역을 기준으로 안쪽과 바깥쪽에 나누어 적용됩니다.


◆ Nexacro Runtime Environment 제약

- Nexacro Runtime Environment는 <line-style> 에 "solid" 값만 설정할 수 있습니다.

활용 예제

• 선 그리기

visible

GraphicsPath 가 화면에 표시될지 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GraphicsStock.visible[= bVisible]

문법 설정

bVisible ::= 'true' | 'false'

var objGraphicsPath = new nexacro.GraphicsPath();

objGraphicsPath.visible = false;

참고

- visible 속성값을 변경하면 화면에 즉시 반영되지 않고 Graphics 컴포넌트의 redraw() 메소드가 수행될 때 반영됩니다.

- GraphicsGroup 의 경우 visible 속성을 false 로 설정하면 하위 오브젝트도 함께 화면에 표시되지 않습니다.

- visible 속성에 의해 화면에 GraphicsPath 가 표시되지 않아도 오브젝트는 존재하기 때문에 스크립트로 제어가 가능합니다.

x

부모 오브젝트를 기준으로 GraphicsPath 가 표시될 x 축 좌표값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GraphicsStock.x[= nX]

문법 설정

var objGraphicsPath = new nexacro.GraphicsPath( ) ;

objGraphicsPath .x = 200;
objGraphicsPath .y = 200;

참고

- x 속성값을 설정하지 않으면 0 으로 적용됩니다.

- x 속성은 컴포넌트의 left 속성에 해당하는 속성입니다.

- Transform 과 관련된 메소드(scale(), rotate() 등)가 수행되어 GraphicsPath 의 표시위치가 변경되어도 x 속성은 원본위치값을 유지합니다.

y

부모 오브젝트를 기준으로 GraphicsPath 가 표시될 y 축 좌표값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GraphicsStock.y[= nY]

문법 설정

var objGraphicsPath = new nexacro.GraphicsPath( ) ;

objGraphicsPath .x = 200;
objGraphicsPath .y = 200;

참고

- y 속성값을 설정하지 않으면 0 으로 적용됩니다.

- y 속성은 컴포넌트의 top 속성에 해당하는 속성입니다.

- Transform 과 관련된 메소드(scale(), rotate() 등)가 수행되어 GraphicsPath 의 표시위치가 변경되어도 y 속성은 원본위치값을 유지합니다.

메서드

arcTo

현재위치에서 인수로 전달된 위치까지 타원호 경로를 GraphicsPath 에 추가하는 메소드입니다.

지원 환경

문법

GraphicsPath.arcTo(  nX, nY, nRadiusX, nRadiusY, nRotation, bClockwise, bLarge )

파라미터

var objGPath = new nexacro.GraphicsPath();

objGPath.moveTo( 100,100 );
objGPath.arcTo( 200, 200, 100, 50, 0, true, false );

참고

- arcTo() 메소드 실행 후 현재위치가 nX, nY 로 변경됩니다.

- GraphicsPath 의 시작위치를 설정하지 않으면 경로가 정상적으로 표시되지 않을 수 있습니다.

- 타원호 경로는 아래와 같은 절차에 의해 결정됩니다.
  1. 타원호는 현재위치에서 시작하여 nX, nY 위치에서 끝납니다.
  2. 타원은 nRadiusX, nRadiusY 값을 가로,세로 반지름으로 갖습니다.
  3. 타원의 x 축은 nRotation 값만큼 회전합니다.
  4. 1~3번 조건에 의해 2개 또는 4개의 타원호 경로가 존재하게 됩니다.
  5. bClockwise 와 bLarge 값에 의해 4번의 타원호 중 1개의 타원호가 경로로 결정됩니다.

bezierCurveTo

현재위치에서 인수로 전달된 위치까지 cubic Bezier 곡선경로를 GraphicsPath 에 추가하는 메소드입니다.

지원 환경

문법

GraphicsPath.bezierCurveTo( nCBeginX, nCBeginY, nCEndX, nCEndY, nX, nY )

파라미터

var objGPath = new nexacro.GraphicsPath();

objGPath.moveTo(100,100);
objGPath.bezierCurveTo(400,200,400,300,300,300);

참고

- cubicCurveTo() 메소드 실행 후 현재위치가 nX, nY 로 변경됩니다.

- 인수로 전달된 좌표는 GrpahicsPath 의 x, y 속성값을 기준으로 처리됩니다.

- GraphicsPath 의 시작위치를 설정하지 않으면 경로가 정상적으로 표시되지 않을 수 있습니다.

clear

GraphicsPath 에 설정된 경로 데이터를 모두 삭제하는 메소드입니다.

지원 환경

문법

GraphicsPath.clear()

closePath

GraphicsPath 에 설정된 경로의 끝점과 시작점을 직선으로 연결하는 메소드입니다.

지원 환경

문법

GraphicsPath.closePath()

파라미터

var objGPath = new nexacro.GraphicsPath();

objGPath.setPathData("M200,40 L100,160 L300,160");
objGPath.closePath();

참고

- 끝점과 시작점을 연결하여 닫힌경로로 만드는 메소드입니다.

- GraphicPath 에 경로 데이터가 없을 경우 closePath() 메소드는 수행되지 않습니다.

destroy

GraphicsPath 를 메모리에서 완전히 삭제하는 메소드입니다.

지원 환경

문법

GraphicsPath.destroy()

반환

참고

- destroy() 메소드로 GraphicsPath 가 삭제되어도 화면에 표시된 오브젝트가 자동으로 사라지지 않습니다.
   Graphics 컴포넌트의 redraw() 메소드를 실행하여야 화면에 변경사항이 반영됩니다.

- GraphicsPath 가 하위 오브젝트를 가질 수 있는 경우 하위 오브젝트도 함께 삭제됩니다.

getBoundRect

GraphicsPath 가 표시되는 영역정보를 Graphics 컴포넌트 기준으로 바깥쪽 외곽선 영역을 포함하여 반환하는 메소드입니다.

지원 환경

문법

GraphicsPath.getBoundRect( );

파라미터

var objGraphicsPath = this.Graphics00.getObjectByID("GraphicsPath00");
var objRect = objGraphicsPath.getBoundRect();

trace( "left : " + objRect.left );

반환

참고

- getBoundRect() 메소드는 GraphicsPath 의 표시여부와 관계없이 논리적인 영역정보를 반환하는 메소드입니다.
   따라서 getBoundRect() 메소드의 반환값으로 GraphicsPath 의 표시여부를 판단할 수 없으므로 사용에 주의하여야 합니다.

- GraphicsPath 에서 Transform 관련 메소드(scale(), rotate() 등)를 실행하면 메소드가 적용된 영역정보를 반환합니다.

- 부모 오브젝트를 기준으로 계산된 영역정보를 얻으려면 getOffsetBoundRect() 메소드를 사용하여야 합니다.

- GraphicsEllipse, GraphicsLine, GraphicsPath, GraphicsPaths, GraphicsRect 오브젝트의 strokepen 속성값은 오브젝트의 실제 영역을 기준으로 안쪽과 바깥쪽에 나누어 적용됩니다.

getNextSibling

GraphicsPath 와 부모가 동일한 Graphics 오브젝트 중 다음 순서의 오브젝트를 반환하는 메소드입니다.

지원 환경

문법

GraphicsPath.getNextSibling()

파라미터

var objGraphicsPath = this.Graphics00.getObjectByID("GraphicsPath00");
var objNext = objGraphicsPath.getNextSibling();

trace( objNext.toString() );

반환

참고

- addChild() 메소드로 추가된 순서대로 Graphics 오브젝트가 저장됩니다.

- 부모가 다른 Graphics 오브젝트는 반환되지 않습니다.

getOffsetBoundRect

GraphicsPath 가 표시되는 영역정보를 Graphics 부모 오브젝트 기준으로 바깥쪽 외곽선 영역을 포함하여 반환하는 메소드입니다.

지원 환경

문법

GraphicsPath.getOffsetBoundRect( );

파라미터

var objGroup = this.Graphics00.getObjectByID("GraphicsGroup00");
var objGraphicsPath = objGroup.getObjectByID("GraphicsPath00");
var objRect = objGraphicsPath.getOffsetBoundRect();

trace( "left : " + objRect.left );

반환

참고

- getOffsetBoundRect() 메소드는 GraphicsPath 의 표시여부와 관계없이 논리적인 영역정보를 반환하는 메소드입니다.
   따라서 getOffsetBoundRect() 메소드의 반환값으로 GraphicsPath 의 표시여부를 판단할 수 없으므로 사용에 주의하여야 합니다.

- GraphicsPath 에서 Transform 관련 메소드(scale(), rotate() 등)를 실행하면 메소드가 적용된 영역정보를 반환합니다.

- Graphics 컴포넌트를 기준으로 계산된 영역정보를 얻으려면 getBoundRect() 메소드를 사용하여야 합니다.

- GraphicsEllipse, GraphicsLine, GraphicsPath, GraphicsPaths, GraphicsRect 오브젝트의 strokepen 속성값은 오브젝트의 실제 영역을 기준으로 안쪽과 바깥쪽에 나누어 적용됩니다.

getOffsetRect

GraphicsPath 가 표시되는 영역정보를 Graphics 부모 오브젝트 기준으로 바깥쪽 외곽선 영역을 포함하여 반환하는 메소드입니다.

지원 환경

문법

GraphicsPath.getOffsetBoundRect( );

파라미터

var objGroup = this.Graphics00.getObjectByID("GraphicsGroup00");
var objGraphicsPath = objGroup.getObjectByID("GraphicsPath00");
var objRect = objGraphicsPath.getOffsetBoundRect();

trace( "left : " + objRect.left );

반환

참고

- getOffsetBoundRect() 메소드는 GraphicsPath 의 표시여부와 관계없이 논리적인 영역정보를 반환하는 메소드입니다.
   따라서 getOffsetBoundRect() 메소드의 반환값으로 GraphicsPath 의 표시여부를 판단할 수 없으므로 사용에 주의하여야 합니다.

- GraphicsPath 에서 Transform 관련 메소드(scale(), rotate() 등)를 실행하면 메소드가 적용된 영역정보를 반환합니다.

- Graphics 컴포넌트를 기준으로 계산된 영역정보를 얻으려면 getBoundRect() 메소드를 사용하여야 합니다.

- GraphicsEllipse, GraphicsLine, GraphicsPath, GraphicsPaths, GraphicsRect 오브젝트의 strokepen 속성값은 오브젝트의 실제 영역을 기준으로 안쪽과 바깥쪽에 나누어 적용됩니다.

getOffsetRegion

GraphicsPath 가 표시되는 영역정보를 부모 오브젝트 컴포넌트 기준으로 안쪽 외곽선 영역을 제외하고 반환하는 메소드입니다.

지원 환경

문법

GraphicsPath.getOffsetRegion( );

파라미터

var objGroup = this.Graphics00.getObjectByID("GraphicsGroup00");
var objGraphicsPath = objGroup.getObjectByID("GraphicsPath00");
var objRect = objGraphicsPath.getOffsetRegion();

trace( "left : " + objRect.left );

반환

참고

- getOffsetRegion() 메소드는 GraphicsPath 의 표시여부와 관계없이 논리적인 영역정보를 반환하는 메소드입니다.
   따라서 getOffsetRegion() 메소드의 반환값으로 GraphicsPath 의 표시여부를 판단할 수 없으므로 사용에 주의하여야 합니다.

- GraphicsPath 에서 Transform 관련 메소드(scale(), rotate() 등)를 실행하면 메소드가 적용된 영역정보를 반환합니다.

- Graphics 컴포넌트를 기준으로 계산된 영역정보를 얻으려면 getRegion() 메소드를 사용하여야 합니다.

- GraphicsEllipse, GraphicsLine, GraphicsPath, GraphicsPaths, GraphicsRect 오브젝트의 strokepen 속성값은 오브젝트의 실제 영역을 기준으로 안쪽과 바깥쪽에 나누어 적용됩니다.

getPathData

GraphicsPath 에 설정된 경로 데이터를 SVG 형식의 문자열로 반환하는 메소드입니다.

지원 환경

문법

GraphicsPath.getPathData()

반환

참고

- 경로 데이터는 공백문자로 구분됩니다.

getPreviousSibling

GraphicsPath 와 부모가 동일한 Graphics 오브젝트 중 이전 순서의 오브젝트를 반환하는 메소드입니다.

지원 환경

문법

GraphicsPath.getPreviousSibling()

파라미터

var objGraphicsPath = this.Graphics00.getObjectByID("GraphicsPath00");
var objPrev = objGraphicsPath.getPreviousSibling();

trace( objPrev.toString() );

반환

참고

- addChild() 메소드로 추가된 순서대로 Graphics 오브젝트가 저장됩니다.

- 부모가 다른 Graphics 오브젝트는 반환되지 않습니다.

getRect

GraphicsPath 의 영역정보를 Graphics 컴포넌트 기준으로 반환하는 메소드입니다.

지원 환경

문법

GraphicsPath.getRect( );

파라미터

var objGraphicsPath = this.Graphics00.getObjectByID("GraphicsPath00");
var objRect = objGraphicsPath.getRect();

trace( "left : " + objRect.left );

반환

참고

- getRect() 메소드는 GraphicsPath 의 표시여부와 관계없이 논리적인 영역정보를 반환하는 메소드입니다.
   따라서 getRect() 메소드의 반환값으로 GraphicsPath 의 표시여부를 판단할 수 없으므로 사용에 주의하여야 합니다.

- GraphicsPath 에서 Transform 관련 메소드(scale(), rotate() 등)를 실행하면 메소드가 적용된 영역정보를 반환합니다.

- 부모 오브젝트를 기준으로 계산된 영역정보를 얻으려면 getOffsetRect() 메소드를 사용하여야 합니다.

- GraphicsEllipse, GraphicsLine, GraphicsPath, GraphicsPaths, GraphicsRect 오브젝트의 strokepen 속성값은 오브젝트의 실제 영역을 기준으로 안쪽과 바깥쪽에 나누어 적용됩니다.

getRegion

GraphicsPath 가 표시되는 영역정보를 Graphics 컴포넌트 기준으로 안쪽 외곽선 영역을 제외하고 반환하는 메소드입니다.

지원 환경

문법

GraphicsPath.getRegion( );

파라미터

var objGraphicsPath = this.Graphics00.getObjectByID("GraphicsPath00");
var objRect = objGraphicsPath.getRegion();

trace( "left : " + objRect.left );

반환

참고

- getRegion() 메소드는 GraphicsPath 의 표시여부와 관계없이 논리적인 영역정보를 반환하는 메소드입니다.
   따라서 getRegion() 메소드의 반환값으로 GraphicsPath 의 표시여부를 판단할 수 없으므로 사용에 주의하여야 합니다.

- GraphicsPath 에서 Transform 관련 메소드(scale(), rotate() 등)를 실행하면 메소드가 적용된 영역정보를 반환합니다.

- 부모 오브젝트를 기준으로 계산된 영역정보를 얻으려면 getOffsetRegion() 메소드를 사용하여야 합니다.

- GraphicsEllipse, GraphicsLine, GraphicsPath, GraphicsPaths, GraphicsRect 오브젝트의 strokepen 속성값은 오브젝트의 실제 영역을 기준으로 안쪽과 바깥쪽에 나누어 적용됩니다.

hasSegments

GraphicsPath 에 경로 데이터가 설정되어 있는지 여부를 반환하는 메소드입니다.

지원 환경

문법

GraphicsPath.hasSegments()

파라미터

var objGPath = new nexacro.GraphicsPath();

objGPath.setPathData("M 15,0 L 0,30 L 30,30Z");
var bResult = objGPath.hasSegments() ;

반환

참고

- moveTo(), lineTo(), arcTo() 와 같은 메소드를 사용하여 경로를 추가합니다.

isHitTest

인수로 전달된 좌표위치가 GraphicsPath 영역에 포함되는지 여부를 반환하는 메소드입니다.

지원 환경

문법

GraphicsPath.isHitTest( nX, nY )

파라미터

var objGraphicsPath = this.Graphics00.getObjectByID("GraphicsPath00");

var bResult = objGraphicsPath.isHitTest( 100, 100 );

반환

참고

- 일반적으로 GraphicsPath 영역은 getRect() 메소드로 반환되는 영역과 일치합니다.
   getRect() 메소드의 반환값은 GraphicsPath 의 상태에 따라 변경될 수 있으므로 isHitTest() 사용에 주의하여야 합니다.

- 인수로 전달된 nX, nY 좌표는 Graphics 컴포넌트의 left, top 을 기준으로 처리됩니다.

isPointInPath

특정 좌표위치가 GraphicsPath 영역에 포함되는지 여부를 반환하는 메소드입니다.

지원 환경

문법

GraphicsPath.isPointInPath( objPoint [, nTolerance] )

파라미터

반환

참고

- GraphicsPath 의 영역은 경로를 모두 포함하는 최소 크기의 사각형입니다.

lineTo

현재위치에서 인수로 전달된 위치까지 직선 경로를 GraphicsPath 에 추가하는 메소드입니다.

지원 환경

문법

GraphicsPath.lineTo( nX, nY )

파라미터

var objGPath = new nexacro.GraphicsPath();

objGPath.moveTo( 0,0 );
objGPath.lineTo( 300,300 );

참고

- lineTo() 메소드 실행 후 현재위치가 nX, nY 로 변경됩니다.

- GraphicsPath 의 시작위치를 설정하지 않으면 경로가 정상적으로 표시되지 않을 수 있습니다.

moveBy

GraphicsPath 의 시작위치를 이동하는 메소드입니다.

지원 환경

문법

GraphicsPath.moveBy( nX, nY )

파라미터

var objGPath = new nexacro.GraphicsPath();

objGPath.moveBy( 300,300 );

참고

- GraphicsPath 의 시작위치를 설정하지 않으면 경로가 정상적으로 표시되지 않을 수 있습니다.

- moveBy() 메소드는 경로의 시작점을 설정할 때 외에는 무시됩니다.

moveTo

GraphicsPath 의 시작위치를 설정하는 메소드입니다.

지원 환경

문법

GraphicsPath.moveTo( nX, nY )

파라미터

var objGPath = new nexacro.GraphicsPath();

objGPath.moveTo( 300,300 );

참고

- GraphicsPath 의 시작위치를 설정하지 않으면 경로가 정상적으로 표시되지 않을 수 있습니다.

- moveTo() 메소드는 경로의 시작점을 설정할 때 외에는 무시됩니다.

quadraticCurveTo

현재위치에서 인수로 전달된 위치까지 quadratic Bezier 곡선 경로를 GraphicsPath 에 추가하는 메소드입니다.

지원 환경

문법

GraphicsPath.quadraticCurveTo( nControlX, nControlY, nX, nY )

파라미터

var objGPath = new nexacro.GraphicsPath();

objGPath.moveTo( 100,100 );
objGPath.quadraticCurveTo( 0, 200, 200, 200 );

참고

- quadraticCurveTo() 메소드 실행 후 현재위치가 nX, nY 로 변경됩니다.

- 인수로 전달된 좌표는 GrpahicsPath 의 x, y 속성값을 기준으로 처리됩니다.

- GraphicsPath 의 시작위치를 설정하지 않으면 경로가 정상적으로 표시되지 않을 수 있습니다.

rotate

GraphicsPath 에 회전효과를 적용하는 메소드입니다.

지원 환경

문법

GraphicsPath.rotate( nAngle [, nCenterX, nCenterY] );

파라미터

참고

- rotate() 메소드 수행 시 Position 과 관련된 속성(x, y 등)은 변경되지 않습니다.
   영역정보를 반환하는 getRect() 와 같은 메소드는 rotate() 메소드가 적용된 영역정보를 반환합니다.

- rotate() 메소드는 GraphicsPath 가 표시되는 위치를 기준으로 수행됩니다.
   따라서 rotate() 메소드를 여러번 수행하면 회전 효과가 누적되어 적용됩니다.

- GraphicsGroup 의 경우 하위 오브젝트에 회전효과가 동일하게 적용됩니다.

- GraphicsPath 에 부모 오브젝트가 설정되어 있어야 rotate() 메소드가 정상적으로 수행됩니다.
   즉, rotate() 메소드 수행 전에 addChild() 메소드로 GraphicsPath 를 등록하여야 합니다.

scale

GraphicsPath 에 확대/축소 효과를 적용하는 메소드입니다.

지원 환경

문법

GraphicsPath.scale( nScaleX, nScaleY [, nCenterX, nCenterY] );

파라미터

참고

- scale() 메소드 수행 시 위치와 관련된 속성(x, y 등)은 변경되지 않습니다.
   영역정보를 반환하는 getRect() 와 같은 메소드는 scale() 메소드가 적용된 영역정보를 반환합니다.

- scale() 메소드는 GraphicsPath 가 표시되는 크기를 기준으로 수행됩니다.
   따라서 scale() 메소드를 여러번 수행하면 확대/축소 효과가 누적되어 적용됩니다.

- GraphicsGroup 의 경우 하위 오브젝트에 확대/축소 효과가 동일하게 적용됩니다.

- GraphicsPath 에 부모 오브젝트가 설정되어 있어야 scale() 메소드가 정상적으로 수행됩니다.
   즉, scale() 메소드 수행 전에 addChild() 메소드로 GraphicsPath 를 등록하여야 합니다.

setClipRect

GraphicsPath 의 일부 영역만 표시되게 Clipping 할 영역의 좌표를 설정하는 메소드입니다.

지원 환경

문법

GraphicsPath.setClipRect( nX, nY, nWidth, nHeight );

파라미터

참고

- GraphicsPath 영역에서 Clipping 영역으로 설정된 부분만 화면에 표시됩니다.
   Transform 과 관련된 메소드(scale(), rotate() 등)가 적용된 경우 GraphicsPath 의 원본영역을 기준으로 Clipping 됩니다.

- "setClipRect( null );" 형태로 파라미터에 null 설정 시 Clipping 영역 설정이 취소됩니다.

- Clipping 이 적용되어도 GraphicsPath 의 Position 관련 속성값은 변경되지 않습니다.

setPathData

GraphicsPath 에 SVG 형식으로 경로 데이터를 설정하는 메소드입니다.

지원 환경

문법

GraphicsPath.setPathData( strPath )

파라미터

var objGPath = new nexacro.GraphicsPath();

objGPath.setPathData("M50,50 H150 V150 H50 Z"); 
objGPath.setPathData("M50,50 L150,50 L150,150 L50,150 L50,50");
objGPath.setPathData("M 10 80 C 40,10 65,10 95,80 S 150,150 180,80");

참고

- "M" 명령어는 경로의 시작점을 설정할 때 외에는 무시됩니다.
   경로를 그리기 시작한 후 입력되는 "M" 명령어는 처리되지 않습니다.

- 경로 데이터는 공백문자로 구분됩니다.

setTransform

GraphicsPath 의 원본 위치를 기준으로 Transform 관련 효과를 연속적으로 적용하는 메소드입니다.

지원 환경

문법

GraphicsPath.setTransform( strMethod );

파라미터

var objGraphicsPath = new nexacro.GraphicsPath();
this.Graphics00.addChild("GraphicsPath00", objGraphicsPath);

objGraphicsPath.setTransform( "translate(50, 50),rotate(20)" );

objGraphicsPath.setTransform(null);

참고

- setTransform() 메소드 수행 시 위치와 관련된 속성(x, y 등)은 변경되지 않습니다.
   영역정보를 반환하는 getRect() 와 같은 메소드는 setTransform() 메소드가 적용된 영역정보를 반환합니다.

- setTransform() 메소드는 GraphicsPath 의 원본 위치를 기준으로 수행됩니다.
   따라서 setTransform() 메소드를 여러번 수행해도 효과가 누적되어 적용되지 않습니다.

- GraphicsGroup 의 경우 하위 오브젝트에 효과가 동일하게 적용됩니다.

- GraphicsPath 에 부모 오브젝트가 설정되어 있어야 setTransform() 메소드가 정상적으로 수행됩니다.
   즉, setTransform() 메소드 수행 전에 addChild() 메소드로 GraphicsPath 를 등록하여야 합니다.

- 메소드 실행 시 strMethod 파라미터 값을 null로 설정하면 transform 효과가 지정되지 않은 상태로 초기화합니다.
  setTransform 메소드로 설정한 transform 효과 뿐 아니라 translate, scale, rotate, shear 메소드로 개별 설정한 상태도 초기화합니다.

shear

GraphicsPath 에 비틀기 효과를 적용하는 메소드입니다.

지원 환경

문법

GraphicsPath.shear( nRadianX, nRadianY [, nCenterX, nCenterY] );

파라미터

참고

- shear() 메소드 수행 시 위치와 관련된 속성(x, y 등)은 변경되지 않습니다.
   영역정보를 반환하는 getRect() 와 같은 메소드는 shear() 메소드가 적용된 영역정보를 반환합니다.

- shear() 메소드는 GraphicsPath 가 표시되는 모습을 기준으로 수행됩니다.
   따라서 shear() 메소드를 여러번 수행하면 비틀기 효과가 누적되어 적용됩니다.

- GraphicsGroup 의 경우 하위 오브젝트에 비틀기 효과가 동일하게 적용됩니다.

- GraphicsPath 에 부모 오브젝트가 설정되어 있어야 shear() 메소드가 정상적으로 수행됩니다.
   즉, shear() 메소드 수행 전에 addChild() 메소드로 GraphicsPath 를 등록하여야 합니다.

toString

GraphicsPath 의 타입을 문자열로 반환하는 메소드입니다.

지원 환경

문법

GraphicsPath.toString();

반환

transform

GraphicsPath 에 Transform 관련 효과를 적용하는 메소드입니다.

지원 환경

문법

GraphicsPath.transform( nScaleX, nShearX, nShearY, nScaleY, nTransX, nTransY );

파라미터

var objGraphicsPath = new nexacro.GraphicsPath();

objGraphicsPath.transform( 1.5, 0, 0, 1.5, 0, 0 );    // scale(1.5,1.5) 와 동일
objGraphicsPath.transform( 1, 0, 0, 1, 50, 50 );      // translate(50, 50) 와 동일

참고

- transform() 메소드 수행 시 위치와 관련된 속성(x, y 등)은 변경되지 않습니다.
   영역정보를 반환하는 getRect() 와 같은 메소드는 transform() 메소드가 적용된 영역정보를 반환합니다.

- transform() 메소드는 GraphicsPath 가 표시되는 모습을 기준으로 수행됩니다.
   따라서 transform() 메소드를 여러번 수행하면 효과가 누적되어 적용됩니다.

- GraphicsGroup 의 경우 하위 오브젝트에 효과가 동일하게 적용됩니다.

- GraphicsPath 에 부모 오브젝트가 설정되어 있어야 transform() 메소드가 정상적으로 수행됩니다.
   즉, transform() 메소드 수행 전에 addChild() 메소드로 GraphicsPath 를 등록하여야 합니다.

translate

GraphicsPath 의 위치가 이동되는 효과를 적용하는 메소드입니다.

지원 환경

문법

GraphicsPath.translate( nTransX, nTransY );

파라미터

참고

- translate() 메소드 수행 시 위치와 관련된 속성(x, y 등)은 변경되지 않습니다.
   영역정보를 반환하는 getRect() 와 같은 메소드는 translate() 메소드가 적용된 영역정보를 반환합니다.

- translate() 메소드는 GraphicsPath 가 표시되는 위치를 기준으로 수행됩니다.
   따라서 translate() 메소드를 여러번 수행하면 이동 효과가 누적되어 적용됩니다.

- GraphicsGroup 의 경우 하위 오브젝트에 이동 효과가 동일하게 적용됩니다.

- GraphicsPath 에 부모 오브젝트가 설정되어 있어야 translate() 메소드가 정상적으로 수행됩니다.
   즉, translate() 메소드 수행 전에 addChild() 메소드로 GraphicsPath 를 등록하여야 합니다.