You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
304 lines
13 KiB
304 lines
13 KiB
2 years ago
|
<!DOCTYPE html>
|
||
|
|
<html lang="ko">
|
||
|
|
<head>
|
||
|
|
<meta charset="utf-8" />
|
||
|
|
<base href="../../../" />
|
||
|
|
<script src="page.js"></script>
|
||
|
|
<link type="text/css" rel="stylesheet" href="page.css" />
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<h1>[name]</h1>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
메쉬, 선, 점 기하학의 표현입니다. 꼭짓점의 위치, 면 순서, 법선, 색상, UV, 버퍼에 있는 커스텀 속성을 포함하고 있으며, 데이터를 GPU에 전달하는
|
||
|
|
자원을 줄여줍니다.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
속성에 있는 데이터를 읽고 수정하려면, [page:BufferAttribute] 문서를 참고하세요.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h2>코드 예제</h2>
|
||
|
|
<code>
|
||
|
|
const geometry = new THREE.BufferGeometry();
|
||
|
|
// create a simple square shape. We duplicate the top left and bottom right
|
||
|
|
// vertices because each vertex needs to appear once per triangle.
|
||
|
|
const vertices = new Float32Array( [
|
||
|
|
-1.0, -1.0, 1.0,
|
||
|
|
1.0, -1.0, 1.0,
|
||
|
|
1.0, 1.0, 1.0,
|
||
|
|
|
||
|
|
1.0, 1.0, 1.0,
|
||
|
|
-1.0, 1.0, 1.0,
|
||
|
|
-1.0, -1.0, 1.0
|
||
|
|
] );
|
||
|
|
|
||
|
|
// itemSize = 3 because there are 3 values (components) per vertex
|
||
|
|
geometry.setAttribute( 'position', new THREE.BufferAttribute( vertices, 3 ) );
|
||
|
|
const material = new THREE.MeshBasicMaterial( { color: 0xff0000 } );
|
||
|
|
const mesh = new THREE.Mesh( geometry, material );
|
||
|
|
</code>
|
||
|
|
|
||
|
|
<h2>예제</h2>
|
||
|
|
<p>
|
||
|
|
[example:webgl_buffergeometry Mesh with non-indexed faces]<br />
|
||
|
|
[example:webgl_buffergeometry_indexed Mesh with indexed faces]<br />
|
||
|
|
[example:webgl_buffergeometry_lines Lines]<br />
|
||
|
|
[example:webgl_buffergeometry_lines_indexed Indexed Lines]<br />
|
||
|
|
[example:webgl_buffergeometry_custom_attributes_particles Particles]<br />
|
||
|
|
[example:webgl_buffergeometry_rawshader Raw Shaders]
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h2>생성자</h2>
|
||
|
|
|
||
|
|
|
||
|
|
<h3>[name]()</h3>
|
||
|
|
<div>
|
||
|
|
새 [name]를 만듭니다. 몇몇 기본값도 설정합니다.
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
<h2>프로퍼티</h2>
|
||
|
|
|
||
|
|
<h3>[property:Object attributes]</h3>
|
||
|
|
<p>
|
||
|
|
이 해시맵은 설정될 속성의 이름을 id로 가지고 있으며 설정해야 할 [page:BufferAttribute buffer] 값을 value로 가지고 있습니다.
|
||
|
|
프로퍼티에 직접 접근하기보다, [page:.setAttribute] 및 [page:.getAttribute]를 통해 이 기하학 속성에 접근하세요.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[property:Box3 boundingBox]</h3>
|
||
|
|
<p>
|
||
|
|
bufferGeometry의 바운딩 박스이며 [page:.computeBoundingBox]()로 계산할 수 있습니다.
|
||
|
|
기본값은 *null*입니다.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[property:Sphere boundingSphere]</h3>
|
||
|
|
<p>
|
||
|
|
bufferGeometry의 바운딩 스피어이며 [page:.computeBoundingSphere]()로 계산할 수 있습니다.
|
||
|
|
기본값은 *null*입니다.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[property:Object drawRange]</h3>
|
||
|
|
<p>
|
||
|
|
렌더링할 기하학의 부분을 정의합니다. 직접 설정하면 안되며 [page:.setDrawRange]를 사용해야 합니다.
|
||
|
|
기본 값은 다음과 같습니다.
|
||
|
|
<code>
|
||
|
|
{ start: 0, count: Infinity }
|
||
|
|
</code>
|
||
|
|
인덱스가 없는 BufferGeometry의 경우, count는 렌더링할 꼭짓점들의 갯수입니다.
|
||
|
|
인덱스가 있는 BufferGeometry의 경우, count는 렌더링할 인덱스의 갯수입니다.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[property:Array groups]</h3>
|
||
|
|
<p>
|
||
|
|
기하학을 그룹으로 나누며 각자의 WebGL 그리기 요청을 통해 렌더링 됩니다.
|
||
|
|
bufferGeometry와 함께 사용되는 재질의 배열을 허용합니다..<br /><br />
|
||
|
|
|
||
|
|
각자의 그룹은 형태의 객체입니다:
|
||
|
|
<code>{ start: Integer, count: Integer, materialIndex: Integer }</code>
|
||
|
|
start는 이 드리기 요청에서 첫 번째 엘레먼드를 지정하지만 – 첫 번째 인덱스가 없는 기하학이기때문이지만,
|
||
|
|
다른 경우는 첫 번째 삼각형 인덱스입니다. Count는 몇 개의 꼭짓점(혹은 인덱스)가 포함되었는지,
|
||
|
|
materialIndex는 사용할 재질 배열 인덱스를 지정합니다.
|
||
|
|
|
||
|
|
배열을 직접 수정하기보다는 [page:.addGroup]를 사용해 그룹을 추가합니다.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
|
||
|
|
<!-- Note: groups used to be called drawCalls
|
||
|
|
|
||
|
|
<h3>[property:Array drawcalls]</h3>
|
||
|
|
<p>
|
||
|
|
For geometries that use indexed triangles, this Array can be used to split the object
|
||
|
|
into multiple WebGL draw calls. Each draw call will draw some subset of the vertices
|
||
|
|
in this geometry using the configured [page:Material shader]. This may be necessary if,
|
||
|
|
for instance, you have more than 65535 vertices in your object.
|
||
|
|
</p> -->
|
||
|
|
|
||
|
|
|
||
|
|
<h3>[property:Integer id]</h3>
|
||
|
|
<p>인스턴스의 고유한 번호입니다.</p>
|
||
|
|
|
||
|
|
<h3>[property:BufferAttribute index]</h3>
|
||
|
|
<p>
|
||
|
|
꼭짓점을 여러 개의 삼각형으로 재 사용할 수 있게 해줍니다; 이를 "indexed triangles"를 사용한다고 합니다.
|
||
|
|
각각의 삼각형은 세 꼭짓점의 인덱스와 연관되어 있습니다. 이 속성은 따라서 각 삼각형 면의 각 꼭짓점의 인덱스를 저장하고 있습니다.
|
||
|
|
|
||
|
|
이 속성이 설정되어 있지 않다면, [page:WebGLRenderer renderer]는 세 연속된 위치가 단일 삼각형을 나타낸다고 추정합니다.
|
||
|
|
|
||
|
|
기본값은 *null* 입니다.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[property:Boolean isBufferGeometry]</h3>
|
||
|
|
<p>
|
||
|
|
Read-only flag to check if a given object is of type [name].
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[property:Object morphAttributes]</h3>
|
||
|
|
<p>
|
||
|
|
[page:BufferAttribute]의 해쉬맵은 기하학의 모프 타겟에 대한 세부정보를 담고 있습니다.<br />
|
||
|
|
Note: Once the geometry has been rendered, the morph attribute data cannot be changed. You will have to call [page:.dispose](), and create a new instance of [name].
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[property:Boolean morphTargetsRelative]</h3>
|
||
|
|
<p>
|
||
|
|
모프 타겟의 행동을 컨트롤하는데에 사용됩니다; true로 설정하면, 모프 타겟 데이터는 absolute positions/normals 대신 relative offsets으로 취급됩니다.
|
||
|
|
|
||
|
|
기본값은 *false* 입니다.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[property:String name]</h3>
|
||
|
|
<p>
|
||
|
|
인스턴스의 임의 이름입니다. 기본값은 빈 문자열입니다.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[property:Object userData]</h3>
|
||
|
|
<p>
|
||
|
|
BufferGeometry에 관한 커스텀 데이터를 저장하는데에 사용될 수 있는 객체입니다. 이 속성은 복제되지 않기 때문에
|
||
|
|
기능에 대한 참조를 포함하고 있어서는 안됩니다.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[property:String uuid]</h3>
|
||
|
|
<p>
|
||
|
|
객체 인스턴스의 [link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID]입니다.
|
||
|
|
자동으로 할당되며 수정할 수 없습니다.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h2>메서드</h2>
|
||
|
|
|
||
|
|
<p>이 클래스에서는 [page:EventDispatcher EventDispatcher] 메서드들이 활용 가능합니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:this setAttribute]( [param:String name], [param:BufferAttribute attribute] )</h3>
|
||
|
|
<p>
|
||
|
|
기하학에 대한 속성을 설정합니다. [page:.attributes]의 내부 해시맵은 속성들의 반복 속도 증가를 위해 유지되기 때문에,
|
||
|
|
속성 프로퍼티 대신 이 메서드를 사용하세요.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[method:undefined addGroup]( [param:Integer start], [param:Integer count], [param:Integer materialIndex] )</h3>
|
||
|
|
<p>
|
||
|
|
기하학에 그룹을 추가합니다; 프로퍼티 상세에 대해서는 [page:BufferGeometry.groups groups] 페이지를 참고하세요.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
|
||
|
|
<h3>[method:this applyMatrix4]( [param:Matrix4 matrix] )</h3>
|
||
|
|
<p>꼭짓점 좌표로 직접 매트릭스 변형을 합니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:this center] ()</h3>
|
||
|
|
<p>바운딩 박스를 기준으로 기하학을 중앙정렬합니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:BufferGeometry clone]()</h3>
|
||
|
|
<p>BufferGeometry의 사본을 만듭니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:this copy]( [param:BufferGeometry bufferGeometry] )</h3>
|
||
|
|
<p>다른 BufferGeometry를 이 BufferGeometry에 복사합니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:undefined clearGroups]( )</h3>
|
||
|
|
<p>모든 그룹을 제거합니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:undefined computeBoundingBox]()</h3>
|
||
|
|
<p>
|
||
|
|
기하학의 바운딩 박스를 계산하고 [page:.boundingBox] 속성을 업데이트합니다.<br />
|
||
|
|
바운딩 박스는 자동으로 계산되지 않습니다. 명시적으로 계산되어야하며 그렇지 않으면 *null* 값입니다.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[method:undefined computeBoundingSphere]()</h3>
|
||
|
|
<p>
|
||
|
|
기하학의 바운딩 스피어를 계산하고 [page:.boundingSphere] 속성을 업데이트합니다.<br />
|
||
|
|
바운딩 스피어는 자동으로 계산되지 않습니다. 명시적으로 계산되어야하며 그렇지 않으면 *null* 값입니다.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[method:undefined computeTangents]()</h3>
|
||
|
|
<p>
|
||
|
|
기하학에 탄젠트 속성을 계산하고 추가합니다.<br />
|
||
|
|
이 계산은 인덱스가 있는 기하학에만 지원되며 위치, 법선, uv 속성이 정의되어야 합니다.
|
||
|
|
When using a tangent space normal map, prefer the MikkTSpace algorithm provided by
|
||
|
|
[page:BufferGeometryUtils.computeMikkTSpaceTangents] instead.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[method:undefined computeVertexNormals]()</h3>
|
||
|
|
<p>면의 법선 평균값을 통해 꼭짓점 법선을 계산합니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:undefined dispose]()</h3>
|
||
|
|
<p>
|
||
|
|
메모리에서 객체를 정리합니다. <br />
|
||
|
|
앱이 동작중인데 BufferGeometry를 삭제하고 싶을 때 호출합니다.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[method:BufferAttribute getAttribute]( [param:String name] )</h3>
|
||
|
|
<p>[page:BufferAttribute attribute]를 특정 이름과 함께 리턴합니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:BufferAttribute getIndex] ()</h3>
|
||
|
|
<p>[page:.index] 버퍼를 리턴합니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:Boolean hasAttribute]( [param:String name] )</h3>
|
||
|
|
<p>특정 이름의 속성이 존재하면 *true*를 리턴합니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:this lookAt] ( [param:Vector3 vector] )</h3>
|
||
|
|
<p>
|
||
|
|
vector - 바라보는 시점의 월드 벡터 입니다.<br /><br />
|
||
|
|
|
||
|
|
공간의 점을 기준으로 기하학을 면을 회전시킵니다. 일반적으로 한 구간에서만 사용되며 루프 구간에서 사용되지 않습니다.
|
||
|
|
일반적인 리얼타임 메쉬 사용은 [page:Object3D.lookAt] 을 사용하세요.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[method:undefined normalizeNormals]()</h3>
|
||
|
|
<p>
|
||
|
|
기하학의 모든 법선 벡터는 1의 크기를 갖습니다.
|
||
|
|
기하학 표면의 광도를 수정합니다.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[method:BufferAttribute deleteAttribute]( [param:String name] )</h3>
|
||
|
|
<p>특정 이름의 [page:BufferAttribute attribute]를 전부 삭제합니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:this rotateX] ( [param:Float radians] )</h3>
|
||
|
|
<p>
|
||
|
|
X 축의 기하학을 회전합니다. 일반적으로 한 구간에서만 사용되며 루프 구간에서 사용되지 않습니다.
|
||
|
|
일반적인 리얼타임 메쉬 회전은 [page:Object3D.rotation] 를 사용하세요.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[method:this rotateY] ( [param:Float radians] )</h3>
|
||
|
|
<p>
|
||
|
|
Y 축의 기하학을 회전합니다. 일반적으로 한 구간에서만 사용되며 루프 구간에서 사용되지 않습니다.
|
||
|
|
일반적인 리얼타임 메쉬 회전은 [page:Object3D.rotation] 를 사용하세요.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[method:this rotateZ] ( [param:Float radians] )</h3>
|
||
|
|
<p>
|
||
|
|
Z 축의 기하학을 회전합니다. 일반적으로 한 구간에서만 사용되며 루프 구간에서 사용되지 않습니다.
|
||
|
|
일반적인 리얼타임 메쉬 회전은 [page:Object3D.rotation] 를 사용하세요.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[method:this scale] ( [param:Float x], [param:Float y], [param:Float z] )</h3>
|
||
|
|
<p>
|
||
|
|
기하학 데이터를 확대/축소합니다. 일반적으로 한 구간에서만 사용되며 루프 구간에서 사용되지 않습니다.
|
||
|
|
일반적인 리얼타임 메쉬 확대/축소는 [page:Object3D.scale] 를 사용하세요.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[method:this setIndex] ( [param:BufferAttribute index] )</h3>
|
||
|
|
<p>[page:.index] 버퍼를 설정합니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:undefined setDrawRange] ( [param:Integer start], [param:Integer count] )</h3>
|
||
|
|
<p>[page:.drawRange] 프로퍼티를 설정합니다. 인덱스가 없는 BufferGeometry에서, count는 렌더링할 꼭짓점의 수입니다.
|
||
|
|
인덱스가 있는 BufferGeometry에서 count는 렌더링할 인덱스의 수입니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:this setFromPoints] ( [param:Array points] )</h3>
|
||
|
|
<p>점 배열로부터 BufferGeometry의 속성을 설정합니다. from an array of points.</p>
|
||
|
|
|
||
|
|
<h3>[method:Object toJSON]()</h3>
|
||
|
|
<p>버퍼 기하학을 three.js [link:https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4 JSON Object/Scene format]로 변환합니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:BufferGeometry toNonIndexed]()</h3>
|
||
|
|
<p>인덱스가 있는 BufferGeometry의 인덱스가 없는 버전을 리턴합니다.</p>
|
||
|
|
|
||
|
|
<h3>[method:this translate] ( [param:Float x], [param:Float y], [param:Float z] )</h3>
|
||
|
|
<p>
|
||
|
|
기하학을 이동합니다. 일반적으로 한 구간에서만 사용되며 루프 구간에서 사용되지 않습니다.
|
||
|
|
일반적인 리얼타임 메쉬 이동은 [page:Object3D.position] 를 사용하세요.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h2>소스코드</h2>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
|
||
|
|
</p>
|
||
|
|
</body>
|
||
|
|
</html>
|