[name]

이 클래스에는 [page:BufferGeometry]와 연관된 속성 데이터(꼭짓점 위치, 면 순서, 법선, 색깔, UV, 모든 커스텀 속성들 등)를 저장하고 있으며, GPU에 보다 효율적으로 데이터를 전송할 수 있게 합니다. 세부사항 및 활용 예제를 확인해보세요.

데이터는 모든 길이가 벡터로 저장되며 ([page:BufferAttribute.itemSize itemSize]로 정의된 값), 일반적으로 인덱스 값으로 전달될 경우 메서드 내에서 밑줄이 쳐지며 자동으로 벡터 길이에 곱해집니다. When working with vector-like data, the .fromBufferAttribute( attribute, index ) helper methods on [page:Vector2.fromBufferAttribute Vector2], [page:Vector3.fromBufferAttribute Vector3], [page:Vector4.fromBufferAttribute Vector4], and [page:Color.fromBufferAttribute Color] classes may be helpful.

생성자

[name]( [param:TypedArray array], [param:Integer itemSize], [param:Boolean normalized] )

[page:TypedArray array] -- 반드시 [link:https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/TypedArray TypedArray]여야 합니다. 버퍼를 시작하는데에 사용됩니다.
배열에는 itemSize * numVertices 엘레먼트가 있어야 하며, numVertices는 [page:BufferGeometry BufferGeometry]와 연관된 꼭짓점의 갯수입니다.

[page:Integer itemSize] -- 특정 꼭짓점과 연관된 배열의 값의 수입니다. 예를 들어 이 속성에서 3개의 벡터(위치, 법선, 색 처럼)를 저장하고 있다면, itemSize는 3이 됩니다.

[page:Boolean normalized] -- (생략가능) 정수 데이터에만 적용됩니다. 버퍼에 있는 기저 데이터가 GLSL 코드에서 값으로 맵핑되는 방식입니다. 예를 들어 [page:TypedArray array]가 UInt16Array의 인스턴스이고, [page:Boolean normalized]가 true면 배열에 있는 0 - +65535 값들은 GLSL 속성에서 0.0f - +1.0f로 매핑될 것입니다. Int16Array (기호 있는)는 -32768 - +32767 가 -1.0f - +1.0f 로 매핑될 것입니다. [page:Boolean normalized]가 false라면, 값은 수정 없이 floats로 변환될 것입니다. 예) 32767은 32767.0f로 변환.

프로퍼티

[property:TypedArray array]

버퍼에 저장되어 있는 데이터를 담고 있는 [page:TypedArray array].

[property:Integer count]

[page:BufferAttribute.itemSize itemSize]로 나눈 [page:BufferAttribute.array array]의 길이를 저장.

버퍼가 3개의 컴포넌트를 저장한 벡터(위치, 법선, 색 등) 저장된 벡터들의 수를 계산합니다.

[property:Boolean isBufferAttribute]

Read-only flag to check if a given object is of type [name].

[property:Integer itemSize]

[page:BufferAttribute.array array]에 저장되는 벡터의 길이.

[property:String name]

이 속성 인스턴스의 임시 이름. 기본값은 빈 문자열입니다.

[property:Boolean needsUpdate]

이 속성이 변했는지와 GPU에 다시 전송해야하는지에 대한 표시입니다. 배열의 값을 수정했다면 이 값을 true로 설정하세요.

이 값을 true로 설정하면 [page:BufferAttribute.version version] 값도 높입니다.

[property:Boolean normalized]

버퍼에 있는 기저 데이터가 GLSL 코드에서 값으로 맵핑되는 방식입니다. 자세한 내용은 위의 생성자 부분을 참고하세요.

[property:Function onUploadCallback]

렌더러가 속성 배열 데이터를 GPU에 전달한 후에 실행되는 함수입니다.

[property:Object updateRange]

포함 객체:
[page:Integer offset]: 기본값은 *0*입니다. 업데이트를 시작할 위치입니다.
[page:Integer count]: 기본값은 *-1*이고, 업데이트 번위를 사용하지 않는다는 의미입니다.

저장된 벡터의 몇몇 컴포넌트들을 업데이트 할 때만 사용됩니다 (예를 들면, 색과 관련된 컴포넌트만 업데이트할 때).

[property:Usage usage]

최적화를 목적으로 특정 데이터 저장 패턴 사용을 정의합니다. [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/bufferData WebGLRenderingContext.bufferData]()의 *usage* 파라미터에 대응됩니다. 기본값은 *THREE.StaticDrawUsage*입니다.

[property:Integer version]

버전값으로, [page:BufferAttribute.needsUpdate needsUpdate] 속성이 true로 설정될 때 증가합니다.

메서드

[method:this applyMatrix3]( [param:Matrix3 m] )

현재 BufferAttribute의 모든 Vector3 엘레먼트에 matrix [page:Matrix3 m]를 적용합니다.

[method:this applyMatrix4]( [param:Matrix4 m] )

현재 BufferAttribute의 모든 Vector3 엘레먼트에 matrix [page:Matrix4 m]를 적용합니다.

[method:this applyNormalMatrix]( [param:Matrix3 m] )

현재 BufferAttribute의 모든 Vector3 엘레먼트에 일반 matrix [page:Matrix3 m]를 적용합니다.

[method:this transformDirection]( [param:Matrix4 m] )

현재 BufferAttribute의 모든 Vector3 엘레먼트에 matrix [page:Matrix4 m]를 적용하고, 엘레먼트를 방향 벡터로 이동합니다.

[method:BufferAttribute clone]()

bufferAttribute 사본을 리턴합니다.

[method:this copy]( [param:BufferAttribute bufferAttribute] )

현재의 BufferAttribute에 다른 BufferAttribute를 붙여 넣습니다.

[method:this copyArray]( array )

[page:BufferAttribute.array array]에 해당 배열(일반 배열 혹은 TypedArray)을 복사합니다.

TypedArray를 복사할 때의 조건에 대한 주의사항은 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/set TypedArray.set] 를 참고해 주세요.

[method:this copyAt] ( [param:Integer index1], [param:BufferAttribute bufferAttribute], [param:Integer index2] )

bufferAttribute[index2]의 벡터를 [page:BufferAttribute.array array][index1]에 복사합니다.

[method:Number getX]( [param:Integer index] )

해당 index의 벡터의 x 컴포넌트 값을 리턴합니다.

[method:Number getY]( [param:Integer index] )

해당 index의 벡터의 y 컴포넌트 값을 리턴합니다.

[method:Number getZ]( [param:Integer index] )

해당 index의 벡터의 z 컴포넌트 값을 리턴합니다.

[method:Number getW]( [param:Integer index] )

해당 index의 벡터의 w 컴포넌트 값을 리턴합니다.

[method:this onUpload]( [param:Function callback] )

onUploadCallback 속성의 값을 설정합니다.

이 값은 [example:webgl_buffergeometry WebGL / Buffergeometry]에서 버퍼가 GPU로 전송된 후에 자유 메모리로 사용됩니다.

[method:this set] ( [param:Array value], [param:Integer offset] )

value -- 복사할 [page:Array] 혹은 [page:TypedArray] 값입니다.
offset -- (생략가능) 복사를 시작할 [page:BufferAttribute.array array] 의 인덱스값입니다.

[page:BufferAttribute.array array]에서 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/set TypedArray.set]( [page:Array value], [page:Integer offset] ) 를 호출합니다.

[page:Array value]가 [page:TypedArray]로 되는 조건에 대해서는 해당 페이지를 참고하세요.

[method:this setUsage] ( [param:Usage value] )

[page:BufferAttribute.usage usage]를 value로 설정합니다.

[method:this setX]( [param:Integer index], [param:Float x] )

x 컴포넌트 값을 설정합니다.

[method:this setY]( [param:Integer index], [param:Float y] )

y 컴포넌트 값을 설정합니다.

[method:this setZ]( [param:Integer index], [param:Float z] )

z 컴포넌트 값을 설정합니다.

[method:this setW]( [param:Integer index], [param:Float w] )

w 컴포넌트 값을 설정합니다.

[method:this setXY]( [param:Integer index], [param:Float x], [param:Float y] )

index의 벡터의 x 및 y 컴포넌트를 설정합니다.

[method:this setXYZ]( [param:Integer index], [param:Float x], [param:Float y], [param:Float z] )

x, y 및 z 컴포넌트를 설정합니다.

[method:this setXYZW]( [param:Integer index], [param:Float x], [param:Float y], [param:Float z], [param:Float w] )

x, y, z 및 w 컴포넌트를 설정합니다.

소스코드

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]